根本原因是VSCode内置终端未加载shell配置（如~/.zshrc），导致rbenv/rvm未激活，ruby和bundle不可用；验证用which ruby，修复需在设置中正确配置terminal.integrated.defaultProfile.osx并重启VSCode。
为什么 bin/rails db:migrate 在 VSCode 终端里报错“command not found”
根本原因不是 Rails 没装，而是 VSCode 内置终端没加载你的 shell 配置（比如 ~/.zshrc），导致 rbenv 或 rvm 未激活，ruby 和 bundle 命令都不可用。你手动打开的 Terminal 窗口能跑通，VSCode 里却不行——大概率是这个。
验证方法：在 VSCode 终端里执行 which ruby，如果输出是 /usr/bin/ruby（系统自带）或直接报错，就坐实了。
- 打开 VSCode 设置（
Cmd+,），搜索terminal.integrated.profiles.osx（macOS）或对应 Windows/Linux 的配置项 - 找到
zsh或bash那一项，确认path指向的是你实际使用的 shell（如/bin/zsh） - 在同一页设置中，把
terminal.integrated.defaultProfile.osx设为刚才选中的 profile - 重启 VSCode（不是重开终端，是整个应用）
db:migrate 执行后没反应、卡住，或提示 “Could not find database configuration”
这是 Rails 找不到 config/database.yml，或者文件存在但格式错误（YAML 对缩进极其敏感）。尤其常见于从模板生成项目后手动改过数据库类型，或用了 Docker 但没挂载配置。
- 检查
config/database.yml是否存在，且第一行是default: &default这类合法 YAML 键 - 确认当前终端工作目录是项目根目录（
pwd输出应含/my-rails-app，不是子目录） - 运行
bin/rails db:migrate --trace，看报错是否指向某一行 YAML 解析失败（比如 tab 替代了空格） - 如果用 Docker Compose，确保
database.yml中的host指向服务名（如db），而非localhost
如何在 VSCode 里一键运行迁移，不切终端
VSCode 的 Tasks 功能可以把你常用的 bin/rails db:migrate 封装成快捷命令，按 Cmd+Shift+P → Tasks: Run Task 就能触发，比手敲快得多，也避免路径出错。
- 在项目根目录创建
.vscode/tasks.json，内容如下：
{
"version": "2.0.0",
"tasks": [
{
"label": "db:migrate",
"type": "shell",
"command": "bin/rails db:migrate",
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true
}
}
]
}
- 保存后，
Cmd+Shift+P→ 输入Tasks: Run Task→ 选db:migrate - 想加个快捷键？打开
Preferences: Open Keyboard Shortcuts (JSON)，加一条：
{"key": "cmd+m", "command": "workbench.action.terminal.sendSequence", "args": {"text": "bin/rails db:migrate\015"}}
- 注意：
\015是回车符，不能省；若用zsh，确保shell配置正确，否则命令可能被截断
迁移成功但数据没变？检查 schema.rb 和环境变量
Rails 默认只在 development 和 test 环境写 schema.rb，而 db:migrate 默认走当前 RAILS_ENV。如果你在终端里设了 RAILS_ENV=production，又没配 production 数据库，迁移会静默失败或连错库。
- 执行
bin/rails env确认当前环境（输出应为development） - 检查
db/schema.rb时间戳是否更新；没更新说明迁移根本没执行到这一步 - 运行
bin/rails db:migrate STATUS查看哪些 migration 已标记为 done - 别依赖
schema.rb判断结构是否最新——它只是 development 环境的快照；生产环境请用db/structure.sql（需配置config.active_record.schema_format = :sql）
最常被忽略的是：VSCode 启动时继承的是登录 shell 的环境，不是你当前终端里临时 export 的变量。所以 RAILS_ENV 或 DATABASE_URL 如果只在某个终端里设过，VSCode 任务里不会自动带上——得显式写进 tasks.json 的 options.env 里。
