注释颜色不生效需先确认作用域匹配：用 Developer: Show Scope Name 查看实际 scope（如 comment.line.number-sign），再在 .sublime-color-scheme 的 rules 中精准配置；避免使用笼统的 "comment"；注意排除 opacity、background 干扰及语法识别错误。
注释颜色改了没反应？先查作用域是否匹配
Sublime 不会告诉你 scope 写错了，它只是跳过不生效的规则。光标停在注释上，按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Developer: Show Scope Name 回车——你会看到类似 source.python comment.line.number-sign.python 这样的完整路径。真正要改的是 comment.line.number-sign，不是笼统的 comment。
不同语言差异很大：
-
comment.line匹配//或# -
comment.block匹配/* */或 Python 的"""多行注释 -
comment.documentation是 DocBlockr、KotlinDoc 等插件注入的，优先级可能更高
如果你只改了 "scope": "comment"，但实际作用域是 comment.line.double-slash，那颜色根本不会变。
用 .sublime-color-scheme 还是 .tmTheme？选对格式再动手
Sublime 当前推荐用 JSON 格式的 .sublime-color-scheme（新项目默认），老式 XML 的 .tmTheme 仍可运行，但容易手写出错。别直接编辑原始文件——它们在 Packages/Color Scheme - Default/ 或第三方包里，更新后就丢。
安全做法：
- 按
Ctrl+Shift+P输入New Color Scheme（需先装PackageDev插件），自动生成标准 JSON 模板 - 保存到
Packages/User/MyTheme.sublime-color-scheme - 在
rules数组里加一条，例如：{ "scope": "comment.line.number-sign", "settings": { "foreground": "#6272a4", "fontStyle": "italic" } } - 保存后，必须进
Preferences → Color Scheme重新选一次你的主题——Sublime 不自动热加载
改完还是灰蒙蒙？检查 opacity 和 background 干扰
很多人设了亮绿色 "#57A64A"，结果注释看起来发虚、偏灰，大概率是这条规则里带了 "opacity": 0.7。这个值会让前景色和背景混合，视觉上严重降饱和。
还有种情况：某条规则偷偷给 comment 加了 "background"，比如 "background": "#282c34"，文字叠在深色块上，可读性反而崩了。
排查建议：
- 在你修改的作用域规则里，搜
opacity和background字段，临时删掉或设为1.0/null测试 - 确认没有其他同名 scope 规则在后面覆盖你——
rules是顺序匹配，靠后的同 scope 会赢 - 右下角语法标识（如
Python）和当前启用的主题必须一致；否则作用域根本不会触发
为什么 .env 或 .toml 注释不跟着变？这不是配色问题
你改完了所有 comment.* 规则，但打开 .env 文件发现注释还是默认灰，不是配色方案没生效，而是 Sublime 根本没把它当 ShellScript 解析。
解决方法很简单：
- 打开一个
.env文件 →View → Syntax → Open all with current extension as…→ 选ShellScript - 同理，
.toml选TOML，.pyi选Python - 这个操作会写入
Packages/User/Extensions.sublime-settings，永久绑定后缀与语法
配色方案只管“怎么画”，不管“画什么内容”——语法识别错了，作用域就全错，再精细的 color scheme 也救不回来。
