需配置Crystal编译器、VSCode扩展、.crystalconfig文件、tasks.json构建任务及launch.json调试器，以实现语法高亮、语义补全、快速编译与断点调试。
如果您希望在 Visual Studio Code 中高效开发 Crystal 语言项目，同时兼顾 Ruby 风格的语法可读性与 C 级别的执行性能，则需配置专用的编辑器支持环境。以下是实现该目标的具体操作路径：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Crystal 编译器与 VSCode 扩展
VSCode 本身不内置 Crystal 支持，必须通过外部编译器和语言扩展协同工作。Crystal 编译器提供语法解析与类型检查能力，而 VSCode 扩展负责代码高亮、跳转与自动补全。
1、打开终端，执行 brew install crystal 安装官方维护的 Crystal 编译器。
2、启动 VSCode，在扩展市场中搜索并安装 Crystal Language Support（作者为 jgaskins）。
3、重启 VSCode，确保状态栏右下角显示 Crystal 语言模式。
二、配置 .crystalconfig 文件启用语义补全
Crystal 扩展默认仅提供基础语法高亮，要激活类 Ruby 的方法链提示与模块内符号跳转，需手动声明项目级配置文件以启用 LSP 功能。
1、在项目根目录下新建文件，命名为 .crystalconfig。
2、向该文件写入内容：{"lsp": true, "auto-reload": true}。
3、保存后，在任意 .crystal 文件中输入 Array.，观察是否弹出包含 new、empty? 等 Ruby 风格方法的补全列表。
三、设置构建任务以调用 crystal build
VSCode 的任务系统可将 Crystal 编译命令集成进快捷键流程，避免频繁切换终端。此步骤使“快速编译”操作与 Ruby 的 ruby -c 类似，但输出为原生二进制。
1、按下 Cmd+Shift+P，输入并选择 Tasks: Configure Task。
2、选择 Create tasks.json file from template → Others。
3、在生成的 tasks.json 中，将 args 字段替换为：["build", "${file}", "-o", "${fileBasenameNoExtension}"]。
4、保存后，使用 Cmd+Shift+B 即可触发 crystal build 并生成可执行文件。
四、启用调试器支持 crystal debug
Crystal 0.40.0 起内置调试协议支持，VSCode 可通过适配器连接运行时调试会话，实现断点、变量查看等 C 级别开发体验。
1、在终端执行 brew install lldb 安装调试器后端。
2、在扩展市场安装 Crystal Debugger（作者为 crystal-lang）。
3、在项目根目录创建 .vscode/launch.json，填入配置块：{"type": "crystal", "request": "launch", "name": "Debug Crystal", "program": "${file}"}。
4、在代码行号左侧点击设断点，按 F5 启动调试，观察变量值实时更新效果。
