Crystal 编译器需先在系统终端可用，再配置Sublime；Sublime仅支持基础语法高亮，无LSP功能、无调试、无自动补全，构建需手动编写Build System且路径含空格时须加引号。
Crystal 编译器没装好，Sublime 里写什么都报错
Sublime 本身不带 Crystal 解析能力，crystal 命令必须能在终端直接调用，否则所有后续配置都无效。macOS 上用 brew install crystal；Ubuntu/Debian 按官方仓库方式添加后 sudo apt install crystal；Windows 用户暂无稳定原生支持，建议改用 WSL2 + Ubuntu 环境安装，避免 mingw 或 MSYS2 编译 Crystal 失败的常见陷阱。
验证是否成功：终端执行 crystal --version，输出类似 Crystal 1.12.0 [97b6e85df] (2026-03-18) 才算到位。若提示 command not found，请先解决 PATH 和编译器安装问题，别急着配 Sublime。
没有语法高亮和跳转？缺的是 language server 配置
Crystal 语言扩展在 Sublime 中并不存在官方维护的成熟插件（VSCode 的 Crystal Language Support 不适用于 Sublime）。这意味着你无法获得 Ruby 风格的方法链补全、Ctrl+Click 跳转定义等 LSP 功能。
可行替代方案只有基础支持：
- 手动设置语法高亮：通过
View → Syntax → Open all with current extension as… → Crystal，但需先安装第三方语法包（如 GitHub 上的sublime-crystal） - 语法包安装路径为
Packages/User/或用 Package Control 搜索crystal-sublime（注意作者和更新时间，多数已停更） - 即使装了语法包，
Array.后也不会弹出方法列表——因为 Sublime 没有集成crystal tool lsp后端，也不支持自动启动该服务
想一键编译？得手写 Build System 并处理路径空格
Sublime 的构建系统本质是 shell 命令封装，Crystal 的 crystal build 对路径敏感，尤其 Windows 下含空格的项目路径会直接失败。
推荐的 Crytal.sublime-build 内容（保存在 Packages/User/）：
{
"shell_cmd": "crystal build \"${file}\" -o \"${file_path}/${file_base_name}\"",
"file_regex": "^([^:]+):([0-9]+):([0-9]+): (.*)$",
"working_dir": "${file_path}",
"selector": "source.crystal",
"variants": [
{
"name": "Run",
"shell_cmd": "cd \"${file_path}\" && \"${file_path}/${file_base_name}\""
}
]
}
关键点：
-
shell_cmd中的双引号必须包裹${file}和输出路径，否则含空格时解析中断 -
file_regex要匹配 Crystal 编译错误格式，例如main.cr:12:5: error: undefined method 'foo'，上面正则才能准确定位到第 12 行 - 不支持自动重建依赖文件（如
require "./lib/foo"引入的模块），每次修改都要手动触发构建
调试、测试、自动补全？Sublime 当前做不到
Crystal 0.40+ 虽然内置 crystal debug 和 LSP 支持，但这些能力严重依赖 VSCode 的调试适配器和语言服务器协议实现。Sublime 的调试插件生态中，没有任何成熟项目对接 crystal debug 协议；也没有插件能稳定拉起 crystal tool lsp 并维持会话。
这意味着：
- 断点、变量监视、步进执行等功能完全不可用
- 无法感知类型错误直到运行
crystal build或crystal run - 重命名符号、查找引用、自动 import 等高级编辑功能全部缺失
如果你需要这些能力，不是 Sublime 配置不到位，而是它当前技术栈不支持——这不是调参问题，是工具边界问题。
