需安装Crystal编译器、语言服务器及VSCode扩展，配置tasks.json实现一键运行，并启用crystal tool format自动格式化。
如果您希望在 Visual Studio Code 中高效开发 Crystal 语言项目，但尚未配置合适的编辑器支持，则可能是由于缺少语法高亮、代码补全或调试集成。以下是为 VSCode 配置 Crystal 开发环境的具体步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Crystal 编译器与语言服务器
Crystal 依赖本地编译器和官方语言服务器（crystal-language-server）提供语义分析与智能提示。需先确保编译器可用，再启用语言服务器供 VSCode 调用。
1、打开终端，执行 brew install crystal 安装 Crystal 编译器。
2、运行 shards install 确保当前项目依赖已解析（若项目含 shard.yml）。
3、执行 curl -fsSL https://raw.githubusercontent.com/crystal-lang/crystal/main/install.sh | bash 验证安装版本是否 ≥ 1.12.0。
4、通过 gem install crystal-language-server 安装语言服务器（需已安装 Ruby 3.1+）。
二、启用 VSCode 扩展支持
VSCode 本身不原生支持 Crystal，必须通过扩展提供语法识别、格式化与错误诊断能力。推荐使用社区维护度高且兼容最新 Crystal 版本的扩展。
1、在 VSCode 左侧活动栏点击扩展图标（或按 Cmd+Shift+X）。
2、搜索并安装 Crystal Language Support（作者：manastech）。
3、重启 VSCode 后，打开任意 .cr 文件，确认右下角状态栏显示 Crystal (via LSP)。
4、在设置中搜索 crystal.executablePath，将其值设为 /opt/homebrew/bin/crystal（Apple Silicon）或 /usr/local/bin/crystal（Intel Mac）。
三、配置自定义任务实现一键编译运行
VSCode 的 tasks.json 可将 crystal run 命令封装为可触发任务，避免频繁切换终端。该配置支持保存即运行与错误跳转。
1、在项目根目录创建 .vscode/tasks.json 文件。
2、填入以下内容：
{ "version": "2.0.0", "tasks": [{ "label": "crystal: run", "type": "shell", "command": "crystal", "args": ["run", "${file}"], "group": "build", "presentation": { "echo": true, "reveal": "always", "focus": false, "panel": "shared", "showReuseMessage": true, "clear": true }, "problemMatcher": [ "$crystal" ] }] }
3、按下 Cmd+Shift+P，输入 Tasks: Run Build Task，选择 crystal: run。
四、启用格式化与自动保存集成
Crystal 社区约定使用 crystal tool format 统一代码风格。VSCode 可将其绑定至保存事件，确保每次写入均符合规范。
1、在 VSCode 设置中搜索 editor.formatOnSave，勾选启用。
2、搜索 editor.defaultFormatter，对 Crystal 文件类型指定格式化器为 manastech.crystal。
3、打开命令面板（Cmd+Shift+P），运行 Preferences: Configure Language Specific Settings...，选择 Crystal，添加："editor.formatOnSave": true, "editor.formatOnType": true。
