需依次安装Crystal编译器、VSCode Crystal扩展、配置格式化工具、启用LLDB调试支持、集成REPL终端；具体包括brew安装crystal-lang、安装watzon扩展、设置crystal.formatTool、配置launch.json及crystal build --debug、设置cry别名。
如果您希望在本地搭建 Crystal 语言的开发环境，并使用 VSCode 作为主要编辑器，则需配置语法支持、代码补全、调试能力及终端集成。以下是完成该环境搭建的具体步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装 Crystal 编译器
Crystal 语言依赖其官方编译器才能解析和执行代码，因此必须首先在系统中安装稳定版本的 crystal 命令行工具。安装方式取决于系统包管理器类型，以下提供两种主流途径。
1、打开终端，执行 brew install crystal-lang 命令（适用于已安装 Homebrew 的 macOS 系统）。
2、若未安装 Homebrew，先运行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 完成基础工具链部署。
3、安装完成后，在终端输入 crystal --version 验证是否输出类似 Crystal 1.12.0 [6f842b57a] (2024-06-12) 的响应。
二、安装 VSCode Crystal 扩展
VSCode 默认不识别 .cr 文件语法，需通过扩展提供高亮、括号匹配、格式化等基础编辑能力。Crystal 官方推荐的扩展由 watzon 维护，具备活跃更新与良好兼容性。
1、启动 VSCode，点击左侧活动栏中的扩展图标（四个方块组成的图标）。
2、在搜索框中输入 Crystal Language Support，找到作者为 watzon 的扩展条目。
3、点击“安装”按钮，等待扩展下载并启用完成。
4、重启 VSCode 后，新建一个 test.cr 文件，确认关键字如 def、class、end 已正确着色。
三、配置 Crystal 格式化工具
Crystal 自带格式化命令 crystal tool format，但 VSCode 需明确指定可执行路径才能触发自动格式化。该步骤确保保存时自动标准化代码缩进与空格。
1、在 VSCode 中按下 Cmd + ,（macOS）打开设置界面，切换至“文本编辑器 > 格式化”选项页。
2、勾选 Format On Save 和 Format On Type。
3、点击右上角“打开设置（JSON）”图标，在 settings.json 中添加如下字段：
SmartB2B 是一款基于PHP、MySQL、Smarty的B2B行业电子商务网站管理系统，系统提供了供求模型、企业模型、产品模型、人才招聘模型、资讯模型等模块，适用于想在行业里取得领先地位的企业快速假设B2B网站，可以运行于Linux与Windows等多重服务器环境，安装方便，使用灵活。 系统使用当前流行的PHP语言开发，以MySQL为数据库，采用B/S架构，MVC模式开发。融入了模型化、模板
"crystal.formatTool": "crystal"
4、保存文件后，对任意 .cr 文件执行 Cmd + S，观察缩进是否按 Crystal 社区风格重排。
四、启用 Crystal 调试支持
Crystal 目前不原生支持 GDB 或 LLDB 直接调试，但可通过 crystal tool exec 生成带调试符号的二进制，并借助 VSCode 的 CodeLLDB 扩展间接实现断点与变量检查。
1、在终端中运行 brew install --cask lldb-vscode 安装适配 macOS 的调试桥接组件。
2、在 VSCode 扩展市场中搜索并安装 CodeLLDB 扩展。
3、在项目根目录创建 .vscode/launch.json，填入以下内容：
{ "version": "0.2.0", "configurations": [{ "type": "lldb", "request": "launch", "name": "Crystal Debug", "program": "${workspaceFolder}/bin/myapp", "args": [], "cwd": "${workspaceFolder}" }] }
4、使用 crystal build --debug src/myapp.cr -o bin/myapp 编译带调试信息的可执行文件。
五、集成 Crystal REPL 到 VSCode 终端
Crystal 提供交互式解释器（crystal eval），将其设为 VSCode 内置终端默认 Shell 可提升快速验证表达式效率，避免频繁切换窗口。
1、在 VSCode 中按下 Cmd + Shift + P，输入 Terminal: Select Default Profile 并回车。
2、从列表中选择 zsh（macOS 默认 shell）。
3、新建终端后，执行 alias cry='crystal eval' 创建快捷命令。
4、输入 cry "puts 'Hello Crystal'"，确认终端立即输出 Hello Crystal。
