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