Sublime Text 支持 Crystal 需手动配置：先安装 Crystal 语法插件实现高亮，再创建 crystal.sublime-build 构建系统（含 crystal run/build 变体），并确保系统 PATH 中 crystal 命令可用且版本 ≥1.12.0；LSP 补全需额外搭配 LSP-Crystal 客户端，Windows 兼容性较差。
Crystal 是基于 LLVM、语法接近 Ruby 的静态类型语言，其编译器 crystal 命令本身即支持编译 + 运行一体化（crystal run 或简写为 crystal），无需额外链接步骤。Sublime Text 默认不识别 Crystal 语法，也不自带构建系统，需手动配置。
安装 Crystal 语言支持插件
Sublime Text 本身不内置 Crystal 语法高亮或自动补全。必须先装插件才能正确识别 .cr 文件：
- 按
Ctrl+Shift+P打开命令面板，输入Package Control: Install Package - 等待仓库加载完成，输入
Crystal，选择Crystal（作者：lukaszb，GitHub 仓库名：sublime-crystal） - 安装后重启 Sublime Text，新建文件并保存为
hello.cr，应自动切换语法为Crystal
注意：该插件仅提供语法高亮和基础 snippets，不包含 LSP 支持；如需跳转定义或实时诊断，需额外搭配 SublimeLSP 插件 + crystal-language-server，但后者在 Windows 上兼容性较差，Linux/macOS 更稳。
配置 Crystal 构建系统（crystal build / crystal run）
Sublime Text 的构建系统本质是调用 shell 命令。对 Crystal，最常用的是 crystal run（直接执行）和 crystal build（生成可执行文件）。推荐优先使用 run，因它自动处理依赖且无需清理中间产物。
操作路径：Tools → Build System → New Build System…，粘贴以下内容并保存为 Crystal.sublime-build：
{
"cmd": ["crystal", "run", "${file}"],
"file_regex": "^(.*?):([0-9]+):([0-9]+)\s*:\s*(.*)$",
"working_dir": "${file_path}",
"selector": "source.cr",
"encoding": "utf-8",
"variants": [
{
"name": "Build",
"cmd": ["crystal", "build", "--no-debug", "${file}"]
},
{
"name": "Build (Release)",
"cmd": ["crystal", "build", "--release", "--no-debug", "${file}"]
}
]
}
关键点说明：
-
file_regex中的正则必须匹配crystal报错格式（如hello.cr:5:7），否则无法跳转到错误行 -
--no-debug可显著缩短构建时间，尤其对含宏的代码；--release启用优化，但首次编译会慢很多 - Windows 用户若提示
'crystal' is not recognized，需确认crystal已加入系统 PATH，并重启 Sublime Text（PATH 不会在运行中动态刷新）
为什么不能直接复用 C 的构建配置？
有人尝试把 C 的 gcc 构建配置改成 crystal，结果失败。根本原因有三个：
-
crystal不接受-o输出路径参数直接跟在源文件后（它用--output或默认命名），而 C 构建里常见的"${file_path}/${file_base_name}"写法会触发语法错误 -
crystal编译失败时输出格式与 GCC 不同，原file_regex无法提取行号列号，导致错误不跳转 -
crystal依赖shards管理包，若项目含shard.yml，直接crystal run xxx.cr会忽略依赖，应改用crystal run src/app.cr或crystal src/app.cr（从项目根目录执行）——这意味着单文件开发和项目开发需不同构建逻辑
所以，不要硬套 C 的模板。单文件开发用上面的 run 配置即可；项目开发建议放弃 Sublime Text 内置构建，改用终端执行 crystal run src/main.cr 或 shards build。
中文路径下运行失败怎么办？
Windows 用户常见现象：文件保存在中文路径（如 D:我的项目hello.cr），构建时报错 Invalid byte sequence in UTF-8 或直接卡住。
这不是 Sublime Text 的 bug，而是 crystal 在 Windows 上对非 ASCII 路径的处理缺陷（截至 crystal 1.11 仍存在）。临时解法只有两个：
- 把项目移到纯英文路径下，例如
C:crystalhello.cr - 或改用 WSL2 + Alpine Linux（musl libc 环境），
crystal对路径编码更健壮，且能发挥静态编译优势
别指望改 encoding 字段能解决——Sublime Text 的 "encoding": "utf-8" 只控制文件读写编码，不干预子进程的环境变量或系统调用路径解析。
