前言
在现代化的开发环境中,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 填写连接信息
填写以下信息:
yaml
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 环境和实际使用经验编写,如有问题欢迎交流讨论。