根本原因是VSCode内置终端未加载shell配置（如~/.zshrc），导致rbenv/rvm未激活、ruby和bundle不可用；需在设置中指定正确shell路径并设为默认profile，重启VSCode后验证which ruby输出是否含.rbenv/shims或.rvm/rubies。
bin/rails db:migrate 在 VSCode 终端里报 command not found 怎么办
根本不是 Rails 没装，而是 VSCode 内置终端没加载你的 shell 配置（比如 ~/.zshrc），导致 rbenv 或 rvm 没激活，ruby 和 bundle 命令都不可用。
- 在 VSCode 终端里执行
which ruby：如果输出是/usr/bin/ruby或直接报错，就确认了问题 - 打开 VSCode 设置（Cmd+,），搜索
terminal.integrated.profiles.osx（macOS）或对应平台配置项 - 找到你实际用的 shell（如
/bin/zsh）那一项，确保path指向正确 - 把
terminal.integrated.defaultProfile.osx设为该 profile，然后重启整个 VSCode（不是重开终端）
迁移命令卡住、没反应或提示 “Could not find database configuration”
Rails 找不到 config/database.yml，或者文件存在但 YAML 格式错误——YAML 对缩进极其敏感，一个 tab 就能让整个文件解析失败。
- 检查
config/database.yml是否存在，且第一行是合法键（如default: &default） - 确认当前终端工作目录是项目根目录（
pwd输出应含项目名，不是app/或db/子目录） - 运行
bin/rails db:migrate --trace，看报错是否指向某行 YAML 解析失败 - 如果用 Docker Compose，
database.yml中的host必须填服务名（如db），不能写localhost
如何用 tasks.json 一键触发迁移，避免手敲命令出错
VSCode 的 tasks.json 不只是快捷方式，它能固化工作目录、环境变量和执行顺序，比手动敲命令更可靠。
- 在项目根目录创建
.vscode/tasks.json，内容必须包含"type": "shell"和"group": "build" - 关键字段
"options": { "cwd": "${workspaceFolder}" }强制工作目录为项目根，防止bin/rails找不到config/application.rb - 命令写成
"command": "bundle exec rails db:migrate"，避免 gem 版本冲突 - 可叠加多个任务：比如先跑
db:migrate，再触发rails types:update（若用 Rails 7.1+ 的 type checking）
为什么别在 SQLTools 插件里右键执行 .rb 迁移文件
vscode-sqltools 只处理纯 SQL 文本，完全不理解 Ruby 语法、ActiveRecord DSL 或 Rails 迁移上下文。
- 它会把
class AddEmailToUsers 当成非法 SQL 直接报错 - 即使你只选中
create_table :users do |t| ... end部分，也缺少事务封装、schema_version 更新、回滚逻辑等核心行为 - 真正执行迁移的是
ActiveRecord::Base.connection+ActiveSupport::Notifications，不是 SQL 客户端 - 想看迁移生成的 SQL？用
rails db:migrate:status --verbose或临时加puts connection.execute("EXPLAIN ...")更直接
