VSCode不执行数据库迁移，vscode-sqltools仅支持手动执行单条SQL，无法处理迁移脚本的依赖顺序和版本追踪；真正自动化迁移需依赖项目集成的CLI工具（如Prisma、Flyctl），通过VSCode终端或tasks.json调用。
为什么 vscode-sqltools 插件跑不了迁移脚本
VSCode 本身不执行数据库迁移，它只是编辑器；所谓“运行迁移脚本”，本质是调用命令行工具（如 flyctl、prisma migrate、sqlx migrate 或自定义 bash 脚本）连接数据库并执行 SQL。很多人装了 vscode-sqltools 就以为能一键迁移，结果发现它只支持手动执行单条语句，不解析 up.sql/down.sql 的依赖顺序，也不做版本追踪。
真正能自动化迁移的，是项目里已集成的 CLI 工具。VSCode 的作用，是帮你快速触发它们，并把输出可视化。
- 确认你项目中是否已有迁移工具：检查
package.json的scripts字段（如"migrate:dev": "prisma migrate dev"），或根目录是否存在migrations/文件夹 + 对应 CLI 可执行文件 - 别在 SQLTools 里右键“Execute Query”去跑整个
20240510_add_user_table.up.sql——它会报错或只执行第一行，因为没处理事务封装和上下文变量 - 如果项目没集成任何迁移工具（比如纯手写 SQL 放在
sql/下），那就不是“自动化迁移”，而是“手动执行 SQL”，此时需自己写npm run exec-sql -- --file migrations/xxx.up.sql这类包装脚本
怎么用 VSCode 终端直接跑迁移命令
最可靠的方式，就是在 VSCode 内置终端（Ctrl+`）里运行项目约定的迁移命令。关键不是“怎么点”，而是“命令是否可复现、可调试”。
- 确保你在项目根目录下打开 VSCode（否则
npm run找不到package.json） - 常用命令示例：
npm run migrate:dev # 或 npx prisma migrate dev --create-only # 或 flyctl postgres connect -a your-app-name --command "psql -d your_db" # 配合本地 migration 脚本
- 如果命令报
command not found，先确认是否已安装 CLI：比如npx prisma应该有响应；若无，运行npm install -D prisma - 避免在终端里 cd 进子目录再跑迁移——多数迁移工具要求工作目录为项目根，否则找不到
prisma/schema.prisma或sqlx.toml
如何用 Tasks 自动化迁移流程
VSCode 的 tasks.json 能把迁移命令变成一键操作（Ctrl+Shift+P → “Tasks: Run Task”），还能串联多个步骤，比如“生成迁移 → 应用到本地库 → 更新类型定义”。
在项目根目录建 .vscode/tasks.json，内容类似：
{
"version": "2.0.0",
"tasks": [
{
"label": "migrate:dev",
"type": "shell",
"command": "npm run migrate:dev",
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": true
}
}
]
}-
"panel": "shared"很重要：让所有迁移任务共用同一个终端，避免每次新开窗口导致环境变量丢失（比如DATABASE_URL） - 如果迁移命令依赖环境变量，别在
tasks.json里硬编码"env": { "DATABASE_URL": "..." }——改用.env文件 + 工具自身加载逻辑（如 Prisma 会自动读.env） - 想加前置校验？可以写复合 task：
"dependsOn": ["check-db-connected"]，但注意 VSCode tasks 不支持条件跳过，失败就中断
保存时自动触发迁移？别这么做
有人想设置“保存 .sql 文件就自动跑迁移”，这非常危险。迁移脚本必须显式触发，原因很实际：
- SQL 文件保存不等于“完成编写”——可能中间状态、语法错误、未测试的 DDL
- 迁移是不可逆操作（尤其生产环境），自动执行违背最小权限原则
- VSCode 的
files.autoSave是毫秒级的，你 Ctrl+S 的瞬间，可能刚删了一行，还没补完NOT NULL约束 - 真要快捷，用键盘快捷键绑定 task：在
keybindings.json加一条{"key": "ctrl+alt+m", "command": "workbench.action.terminal.runActiveFile"}，然后把迁移命令写进单独的migrate.sh文件里
迁移的核心从来不是“怎么点更快”，而是“谁在什么时候、以什么权限、对哪个环境做了什么变更”。VSCode 只负责让你看清命令、方便触发、不丢上下文——剩下的，得靠流程卡点和人盯。
