VSCode 配合 Crystal 开发需以 crystal CLI 为基石，安装官方 Crystal Language Support 和 TODO Highlight 插件，配置格式化、LSP 及调试（lldb/gdb），采用 src/ + spec/ 极简结构，所有功能均围绕 crystal tool 展开。
VSCode 配合 Crystal 语言开发，确实能兼顾 Ruby 的简洁表达力和 C 的底层控制力——关键不在工具本身多强大，而在配置是否贴合 Crystal 的实际开发流。
基础环境：别跳过 crystal CLI 这一环
Crystal 编译器（crystal 命令）是 VSCode 插件能力的基石。语法高亮、类型提示、跳转定义等功能，都依赖它提供的 crystal tool 子命令。Mac 用户用 Homebrew 安装后记得确认 which crystal 可用；Linux 用户注意官方 .deb/.rpm 包自带 shell 路径配置，手动编译安装则需把 bin 目录加入 $PATH。
- 运行
crystal env查看 SDK 路径，插件常需此信息定位标准库 - 确保
crystal tool format和crystal tool lsp均可执行——后者是语言服务器核心
核心插件：只装两个真正干活的
Crystal 官方维护的 Crystal Language Support（作者：crystal-lang）已覆盖绝大多数需求。它内建 LSP 支持，无需额外配 rls 或 clangd 类工具。另一个实用插件是 TODO Highlight，Crystal 社区习惯用 # TODO / # FIXME 标记待办，比 Ruby 的 # TODO: 更统一，高亮后一眼可见。
- 禁用 Ruby 插件（如 Solargraph），避免符号解析冲突
- 在
settings.json中加"crystal.formatOnSave": true，保存即格式化 - 若项目含
shards.yml，插件会自动识别依赖，悬停查看模块文档
调试体验：用 lldb 直接啃汇编也不突兀
Crystal 编译为本地机器码，VSCode 的 C/C++ 扩展（ms-vscode.cpptools）配合 lldb（macOS）或 gdb（Linux）就能调试。不需要 Ruby 那套 binding.pry 式交互——你可以在断点处直接打印寄存器值、单步进汇编指令，而语法仍是熟悉的 pp user.name。
- 生成带调试信息的二进制：
crystal build --debug src/app.cr -
launch.json中指定"type": "cppdbg"，路径指向刚生成的可执行文件 - 按
F5启动后，变量视图显示真实内存布局，非 Ruby 那种隐藏对象头的抽象层
项目结构：拥抱 src/ + spec/ 的极简主义
Crystal 社区几乎不用 Rails 那套目录嵌套，一个 src/my_app.cr 就是入口，spec/my_app_spec.cr 对应测试。VSCode 的文件搜索（Ctrl+P）输入 my_app spec 瞬间定位双文件，比 Ruby 的 app/models/user.rb + spec/models/user_spec.rb 路径更短、意图更直白。
- 右键文件 → “Run Crystal File” 快速验证小脚本，不启动完整 test suite
- 终端中执行
crystal spec时，错误行号精准对应 VSCode 打开的文件位置 - 新建文件时，插件自动补全
require "./src/**"路径，省去手敲相对引用
基本上就这些。Crystal 在 VSCode 里不靠花哨功能取胜，而是让编译器能力自然透出——写得像 Ruby，跑得像 C，调得像系统程序。不复杂但容易忽略的是：始终以 crystal CLI 为信任源，其他插件只是它的翻译器。
