前言
在现代化的开发环境中，IDE 与数据库的集成变得越来越重要。Cursor IDE 作为一款强大的 AI 驱动的代码编辑器，通过 SQLTools 扩展可以实现与 MySQL 数据库的无缝集成，让开发者能够在编写代码的同时直接查询和操作数据库，大大提高开发效率。
本文基于 Windows 11 环境，详细介绍如何在 Cursor IDE 中配置和使用 SQLTools 连接 MySQL 数据库。
1. 安装 SQLTools 扩展
1.1 安装步骤
- 在 Cursor IDE 中按
Ctrl + Shift + X打开扩展市场 - 搜索 "SQLTools"
- 安装以下两个扩展：
- SQLTools（主扩展）
- SQLTools MySQL/MariaDB（MySQL 驱动）
1.2 为什么选择 SQLTools
相比其他数据库扩展，SQLTools 具有以下优势：
- 功能最全面，支持多种数据库
- 界面友好，操作简单
- 支持查询结果导出
- 有很好的语法高亮和自动补全
- 支持连接管理，可以保存多个连接
2. 配置数据库连接
2.1 创建新连接
方法一：通过命令面板
- 按
Ctrl + Shift + P打开命令面板 - 输入 "SQLTools: Add New Connection"
- 选择 "MySQL"
方法二：通过侧边栏
- 点击左侧活动栏的 SQLTools 图标（数据库图标）
- 点击 "Add New Connection" 按钮
2.2 填写连接信息
填写以下信息：
Connection Name: xxxx-local
Server: localhost
Port: 3306
Database: xxxx
Username: root
Password: 123456详细配置说明：
- Connection Name: 自定义连接名称，用于标识不同的数据库连接
- Server : 数据库服务器地址，本地开发通常为
localhost - Port : MySQL 默认端口
3306 - Database: 要连接的数据库名称
- Username: 数据库用户名
- Password: 数据库密码
2.3 密码模式设置
在配置密码时，会遇到 "Password mode" 下拉菜单，推荐设置：
本地开发环境：
- 选择 "Save as plaintext in settings"
- 允许直接输入密码并保存
- 适合本地开发环境
2.4 测试连接
- 填写完信息后，点击 "Test Connection"
- 如果连接成功，会显示 "Connection successful"
- 点击 "Save Connection" 保存连接
3. 使用 SQLTools 查询数据
3.1 通过 SQLTools 侧边栏
步骤：
- 点击左侧活动栏的 SQLTools 图标
- 展开你的连接
xxxx-local - 展开
xxxx数据库 - 可以看到所有表
执行查询：
- 右键点击连接名 → 选择 "New SQL File"
- 或者点击 "New Query" 按钮
- 输入 SQL 语句，按
Ctrl + Enter执行
3.2 通过命令面板
- 按
Ctrl + Shift + P打开命令面板 - 输入 "SQLTools: New SQL File"
- 选择你的连接
- 开始编写 SQL 查询
3.3 常用查询示例
查看表结构：
sql
DESCRIBE xxxx_table;查询最近的数据：
sql
SELECT * FROM xxxx_table
ORDER BY create_time DESC
LIMIT 10;查询特定状态的数据：
sql
SELECT id, name, status, create_time
FROM xxxx_table
WHERE status = 'ACTIVE'
ORDER BY create_time DESC;4. 执行数据库操作
4.1 创建表
基本创建表语句：
sql
CREATE TABLE test_table (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
name VARCHAR(100) NOT NULL,
email VARCHAR(255),
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);按照项目规范创建表：
sql
CREATE TABLE user_info (
id BIGINT AUTO_INCREMENT COMMENT '自增id' PRIMARY KEY,
username VARCHAR(50) NOT NULL COMMENT '用户名',
email VARCHAR(100) COMMENT '邮箱',
phone VARCHAR(20) COMMENT '手机号',
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL COMMENT '创建时间',
update_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
create_by VARCHAR(50) DEFAULT '' NOT NULL COMMENT '创建者',
update_by VARCHAR(50) DEFAULT '' NOT NULL COMMENT '更新者',
is_deleted INT DEFAULT 0 NOT NULL COMMENT '软删除状态,0:正常,1:已被软删除'
);4.2 创建带索引的表
sql
CREATE TABLE order_info (
id BIGINT AUTO_INCREMENT COMMENT '自增id' PRIMARY KEY,
order_no VARCHAR(50) UNIQUE NOT NULL COMMENT '订单号',
shop_id BIGINT NOT NULL COMMENT '门店ID',
customer_name VARCHAR(100) COMMENT '客户姓名',
total_amount DECIMAL(10,2) NOT NULL COMMENT '订单总金额',
status VARCHAR(20) DEFAULT 'PENDING' COMMENT '订单状态',
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL COMMENT '创建时间',
update_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
create_by VARCHAR(50) DEFAULT '' NOT NULL COMMENT '创建者',
update_by VARCHAR(50) DEFAULT '' NOT NULL COMMENT '更新者',
is_deleted INT DEFAULT 0 NOT NULL COMMENT '软删除状态,0:正常,1:已被软删除',
INDEX idx_shop_id (shop_id),
INDEX idx_order_no (order_no),
INDEX idx_status (status),
INDEX idx_create_time (create_time)
);5. 实用技巧和最佳实践
5.1 快捷键（Windows 11）
Ctrl + Enter: 执行当前 SQLCtrl + Shift + E: 执行选中的 SQLF5: 刷新连接Ctrl + Shift + P: 打开命令面板
5.2 右键菜单功能
- 右键点击表名 → "Show Table Records" 查看所有数据
- 右键点击表名 → "Describe Table" 查看表结构
- 右键点击表名 → "Generate SELECT" 生成查询语句
5.3 连接管理
- 可以保存多个数据库连接
- 支持不同环境的数据库配置
- 可以快速切换连接
5.4 安全建议
本地开发环境：
- 使用 "Save as plaintext in settings" 模式
- 方便快速连接和开发
6. 总结
通过配置 SQLTools 扩展，我们可以在 Cursor IDE 中实现：
- 可视化数据库操作 - 通过侧边栏直接查看和操作数据库
- SQL 文件管理 - 创建和管理 SQL 查询文件
- 连接管理 - 管理多个数据库连接
- 语法高亮和自动补全 - 提高 SQL 编写效率
- 查询结果展示 - 直观查看查询结果
注意： 如果需要在 Cursor 的聊天窗口中通过 AI 助手直接操作数据库，还需要额外配置 MCP MySQL 服务器。具体的可以参看Cursor集成MCP MySQL服务器完整配置指南
7. 扩展阅读
本文基于 Windows 11 环境和实际使用经验编写，如有问题欢迎交流讨论。