VSCode本身不执行数据库迁移，真正执行的是项目集成的Node.js迁移工具（如knex、Prisma等）；关键在于确认工具是否已安装、命令能否在终端运行，并通过终端或tasks.json可靠执行。
VSCode 本身不执行数据库迁移，它只是编辑器；真正干活的是你项目里集成的 Node.js 迁移工具（比如 knex、prisma、db-migrate 或 typeORM），VSCode 只负责调用它们——关键不是“怎么点”，而是“命令是否在终端里能跑通”。
确认项目是否已集成迁移工具
别急着右键执行 SQL 文件。先看项目有没有真正的迁移能力：
- 检查
package.json的scripts字段：是否存在类似"migrate:dev": "knex migrate:latest"或"prisma:migrate": "prisma migrate dev"这样的脚本 - 检查根目录下是否有
migrations/文件夹，且里面是带时间戳的.js或.sql文件（如20240510123456_create_user_table.js） - 运行
npx knex --version或npx prisma --version，有输出才说明 CLI 已安装可用 - 如果只有
sql/目录和一堆手写.sql文件，那不属于“迁移”，只是手动 SQL 执行，需要自己包装脚本才能复用
在 VSCode 终端里正确执行迁移命令
这是最稳定、最可调试的方式。很多报错其实只因为路径或环境不对：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 必须在项目根目录打开 VSCode（不是子文件夹），否则
npm run找不到package.json - 用快捷键
Ctrl + `（Windows/Linux）或Cmd + `（macOS）打开集成终端，不要另开系统终端 - 确认当前路径：终端第一行应显示类似
your-project-name$；若显示~/Downloads$，就先cd /path/to/your/project - 常用命令示例：
npx knex migrate:latestnpx prisma migrate devnpm run migrate:prod
注意：不要加sudo，Node 工具通常不需要 root 权限 - 如果报
command not found，先运行npm install -D knex（或对应工具），再试
避免用 SQLTools 插件跑迁移脚本
vscode-sqltools 插件只适合执行单条语句或简单查询，对迁移脚本天然不兼容：
- 它不会按文件名时间戳排序执行
up.sql，也不会跳过已记录的迁移版本 - 遇到
CREATE TABLE IF NOT EXISTS或变量替换（如${env.DB_NAME}）会直接报错 - 事务不封装：一个文件里多条语句，它可能只执行前几行就卡住或中断
- 右键
Execute Query整个20240510_add_user.up.sql→ 大概率只执行第一行BEGIN就停，后续全丢弃
用 tasks.json 把迁移变成一键操作
如果你常要连跑几步（比如生成迁移 → 应用 → 更新类型定义），tasks.json 比反复敲命令更可靠：
- 在项目根目录建
.vscode/tasks.json，内容类似：
{
"version": "2.0.0",
"tasks": [
{
"label": "migrate:dev",
"type": "shell",
"command": "npx prisma migrate dev --create-only",
"group": "build",
"presentation": { "echo": true, "reveal": "always", "panel": "shared" }
}
]
}
- 保存后按
Ctrl+Shift+P→ 输入Tasks: Run Task→ 选migrate:dev - 支持串联：加
"dependsOn": ["migrate:dev"]可自动触发后续任务（如npx prisma generate） - 注意：所有命令仍以项目根为工作目录，
cwd字段不用改，改了反而容易出错
迁移不是“点一下就完事”的操作，核心在于 CLI 工具是否就位、命令是否可复现、错误是否能在终端里直接看到。别让插件替你做决定，自己掌控命令流才是关键。
