在 Cursor IDE 中配置 SQLTools 连接 MySQL 数据库指南（Windows 11）-EW帮帮网

前言

在现代化的开发环境中，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 常用查询示例

查看表结构：

DESCRIBE xxxx_table;

查询最近的数据：

SELECT * FROM xxxx_table 
ORDER BY create_time DESC 
LIMIT 10;

查询特定状态的数据：

SELECT id, name, status, create_time
FROM xxxx_table 
WHERE status = 'ACTIVE'
ORDER BY create_time DESC;

4. 执行数据库操作

4.1 创建表

基本创建表语句：

CREATE TABLE test_table (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    email VARCHAR(255),
    create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

按照项目规范创建表：

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 创建带索引的表

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: 执行当前 SQL
Ctrl + Shift + E: 执行选中的 SQL
F5: 刷新连接
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服务器完整配置指南

本文基于 Windows 11 环境和实际使用经验编写，如有问题欢迎交流讨论。

在 Cursor IDE 中配置 SQLTools 连接 MySQL 数据库指南（Windows 11）

前言