crystal语法高亮未生效需依次检查：安装官方crystal包、手动切换语法、绑定.cr扩展名、确认主题支持对应scope；宏和插值等高亮异常属编辑器限制，非配置问题。
Crystal 语法高亮没生效？先确认是否装对了包
Sublime Text 默认不带 Crystal 支持，得手动装语法定义包。别去搜“Crystal 插件”——那多半是旧版或命名混乱的第三方包。真正可用的是官方维护的 Crystal 语法包，托管在 Package Control 的仓库里，名字就叫 Crystal（注意大小写）。
- 在 Sublime 中按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package回车 - 等列表加载完，输入
Crystal，选中它安装 - 安装完不会自动启用，得手动切换语法：右下角点击当前语法名（比如
Plain Text），选Crystal
常见错误现象：Crystal 文件打开后仍是灰色文字、无关键字着色；或者切换语法后，def、end 等词没变色——大概率是装了名字相近的 Crystal Language 或 Crystal Syntax，这些已多年未更新，不支持 Crystal 1.0+ 的新语法（如 begin...rescue...else...ensure 块嵌套高亮）。
文件关联不上 .cr 扩展名？改 User Settings 就行
装好语法包后，.cr 文件仍不自动高亮，说明 Sublime 没把扩展名和 Crystal 语法绑定。这不是 bug，是默认行为——它只对极少数扩展名（如 .rb）做开箱即用映射。
- 打开菜单
Preferences → Settings – User - 在右边 JSON 配置块里加这一行：
"extensions": ["cr"]，整个配置看起来像这样：
{
"extensions": ["cr"]
}
- 保存后，所有
.cr文件会自动用Crystal语法打开
注意：别往 Settings – Syntax Specific 里加，那是针对单个语法的设置项；也别碰 Packages/Crystal/ 目录下的 Crystal.sublime-settings，那个控制的是语法渲染细节（比如是否高亮注释里的 TODO），不是文件绑定。
高亮颜色太淡或关键字漏掉？检查 color scheme 兼容性
Crystal 语法包本身只定义“哪些文本属于什么 scope”，比如 keyword.control.crystal 表示 if、for 这类控制关键字。最终显示成什么颜色，取决于你当前用的 color scheme（主题）是否覆盖了这些 scope。
- 打开任意
.cr文件，按Ctrl+Shift+P输入Developer: Show Scope Name，把光标停在def上，看底部状态栏显示的 scope 名（通常是keyword.control.crystal） - 如果你的主题没定义这个 scope，它就会回落到默认灰色
解决办法只有两个：换主题，或微调当前主题。推荐先试 Monokai 或 Adaptive，它们对现代语言支持较全；如果非用当前主题不可，就得编辑它的 .sublime-color-scheme 文件，加上对应 scope 的颜色规则——但这涉及 JSON 结构和 scope 优先级，容易配错导致整页变色，普通用户不建议硬刚。
为什么有些结构（如宏、插值字符串）高亮异常？这是语法解析限制
Crystal 是编译型语言，有宏系统、字符串插值、类型推导等动态特性，而 Sublime 的语法高亮基于正则和上下文栈，无法执行代码或解析 AST。所以会出现：
-
"#{"hello".upcase}"里.upcase可能不被识别为方法调用，只当普通文本 - 宏块
{% if flag %}...{% end %}在某些嵌套深度下会断掉高亮链 - 泛型类型
Array(String)中的括号可能被误判为函数调用
这不是配置问题，是文本编辑器语法高亮的固有边界。只要核心关键字（def、class、require）、基础控制流、字符串/注释能正确着色，就说明配置成功。更精确的语义高亮得靠 LSP 插件（比如 Crystal Language Server + LSP 包），但那属于补全和跳转范畴，和语法高亮不是一回事。
实际用的时候，别盯着插值或宏的高亮是否完美——它们不影响编码，也极少干扰阅读。真正要盯紧的，是 def 和 end 是否成对变色、注释是否绿色、数字是否蓝色，这些才是高亮是否“工作正常”的信号。
配完之后，重启 Sublime 不必要，但如果你之前开了很多 .cr 文件，最好关掉重开，避免缓存干扰。另外，Crystal 语法包更新频繁，建议隔一两个月在 Package Control 里检查下更新，尤其当你升级了 Crystal 编译器版本之后。
