需依次安装Ruby（用rbenv管理）、Rails、Node.js、Yarn，配置VSCode的Ruby、Rails、Solargraph等扩展，创建Rails项目并导入VSCode，最后配置launch.json启用调试功能。
如果您希望在本地机器上开始Ruby on Rails项目开发，但尚未配置VSCode作为主要编辑器，则需要完成Ruby、Rails、Node.js、Yarn及VSCode扩展等多组件协同安装与设置。以下是具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装Ruby运行时
Ruby是Rails框架的底层语言运行环境，必须先确保系统中存在兼容版本的Ruby解释器。推荐使用rbenv进行版本管理，避免与系统Ruby冲突。
1、打开终端，执行命令安装Homebrew（若尚未安装）：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2、通过Homebrew安装rbenv：brew install rbenv
3、初始化rbenv并添加至shell配置文件：rbenv init，按输出提示将对应代码追加至~/.zshrc
4、重启终端后，安装Ruby 3.2.2：rbenv install 3.2.2
5、设为全局默认版本：rbenv global 3.2.2
二、安装Rails及依赖工具
Rails本身依赖于JavaScript运行时和包管理器，需同步安装Node.js与Yarn，以支持Asset Pipeline及现代前端集成。
1、使用Homebrew安装Node.js：brew install node
2、安装Yarn：brew install yarn
3、通过gem安装Rails最新稳定版：gem install rails
4、验证安装结果：rails --version，应返回类似“Rails 7.1.3.4”的输出
三、配置VSCode核心扩展
VSCode需借助扩展提供Ruby语法高亮、调试支持、LSP语言服务及Rails专属功能，缺失任一关键扩展将影响开发效率。
1、启动VSCode，在扩展面板搜索并安装：Ruby（由rebornix提供）
2、安装：Rails（由bung87提供）
3、安装：Solargraph（用于Ruby LSP支持）
4、安装：ESLint与Prettier（用于JavaScript/CSS格式化）
5、在VSCode设置中启用Solargraph自动启动："solargraph.autoStart": true
四、创建首个Rails项目并导入VSCode
新建项目需在终端中完成，随后以文件夹形式在VSCode中打开，确保工作区识别Rails结构并激活相关扩展功能。
1、在终端执行：rails new blog_app --database=sqlite3
2、进入项目目录：cd blog_app
3、启动VSCode并打开当前文件夹：code .
4、首次打开时，VSCode右下角可能弹出“Detected Rails project”提示，点击Allow启用Rails扩展特性
5、在VSCode中按下Cmd+Shift+P，输入“Developer: Reload Window”，确认重载以激活全部扩展
五、启用Ruby调试功能
调试能力依赖于VSCode的launch.json配置与ruby-debug适配器，需手动建立调试入口并指定Ruby解释器路径。
1、在VSCode中按下Cmd+Shift+P，输入“Debug: Open launch.json”，选择Ruby环境
2、替换生成的configurations数组内容为：{"name": "Rails Server","type": "Ruby","request": "launch","cwd": "${workspaceFolder}","program": "${workspaceFolder}/bin/rails","args": ["server"]}
3、确认Ruby路径正确：在终端执行which ruby，将输出路径填入launch.json的rubyVersionManager字段（如使用rbenv，则设为"rbenv"）
4、在app/controllers/application_controller.rb任意行左侧点击设置断点
5、按Fn+F5启动调试，访问http://localhost:3000触发断点停靠
