Sublime Text 语法高亮失效主因是扩展名未绑定语法文件，需通过“Open all with current extension as…”写入用户配置；确认语法包路径正确、无大小写错误，并用“Show Scope Name”验证是否加载成功。
Sublime Text 默认不把 .sh、.nim、.proto 这类脚本文件当对应语言处理，不是插件没装，是扩展名根本没绑定到语法定义——点右下角选“Bash”只临时生效，关掉就丢。
为什么右下角选了 Bash / Nim / Protocol Buffer 还是不着色？
因为 Sublime 的语法选择菜单只是“当前视图覆盖”，不改文件后缀关联。你点一次 Bash，它只告诉这个 tab：“这次用 Packages/ShellScript/Bash.sublime-syntax 解析”，下次打开同个 script.sh 文件，又回到 Plain Text。
- 真正起效必须走
Open all with current extension as…——这是唯一写入用户映射规则的动作 - 路径必须完全匹配：比如
Packages/ShellScript/Bash.sublime-syntax，写成shellscript（小写 s）或漏掉.sublime-syntax后缀，加载失败且无报错 - ST4 必须用
.sublime-syntax格式；ST3 若强行加载该格式会报Unable to load syntax file
怎么确认语法包真装对了、路径也写对了？
别靠“Package Control: List Packages”里有名字就放心。很多插件名字像但实际失效，比如 NimLSP 是 LSP 服务端，不提供高亮；Google Protocol Buffers 停更多年，连 import "google/protobuf/timestamp.proto" 都解析不了。
- 先按
Ctrl+Shift+P输入PackageResourceViewer: Open Resource，展开对应包，确认存在Bash.sublime-syntax、Nim.tmLanguage或Protocol Buffer.sublime-syntax - 再打开一个真实文件（如
test.sh），点右下角 →Open all with current extension as…→ 选目标语法，Sublime 会自动在Packages/User/Preferences.sublime-settings里加一条"extensions": ["sh"]映射 - 如果点了没反应，重启 Sublime 再试——有些插件（如
ShellScriptImproved）会劫持语法加载逻辑
执行关联设置后还是灰色？用 Scope Name 验证是否真加载
颜色不对、关键字不着色，90% 是语法没真正加载成功，而不是主题问题。高亮靠两层：语法定义打标签（source.shell.bash）、主题渲染颜色。先确认第一层有没有。
- 按
Ctrl+Shift+P输入Developer: Show Scope Name，把光标停在for或[[上 - 如果输出是
source.shell.bash keyword.control.shell，说明语法加载成功；如果是text.plain或source.shell（没.bash），说明绑定失败或被覆盖 - 检查
Packages/User/Preferences.sublime-settings里有没有冲突项，比如"*.sh": "Plain Text"会直接屏蔽所有绑定
不同脚本类型要特别注意的坑
不是所有语法包都一视同仁，关键差异直接影响你能不能看清代码：
-
.sh：必须选Bash，不是Shell-Unix-Generic。后者不认识[[ ]]、declare -A、${arr[@]:0:2}，全标红或当普通字符串 -
.nim：装NimLime或Nim Language Support，别装NimLSP；装完必须手动绑.nim扩展名，否则永远Plain Text -
.proto：只认Protocol Buffer（作者 xwmx 或 bennettp123），optional被高亮是正常现象（proto3 已废弃但语法保留） -
.conf（Nginx）：千万别全局绑"extensions": ["conf"]，否则redis.conf、logrotate.conf全套上 Nginx 关键字，timeout 在 Redis 是数字，在 Nginx 是带单位字符串，颜色错位反而干扰判断
最常卡住的地方，其实是路径大小写、文件后缀拼写、以及插件是否真解压到了 Packages/ 下对应目录——这些地方错一个字符，高亮就静默失效，连错误提示都没有。
