多行注释高亮失效，先查语法scope：光标停在注释内按Ctrl+Shift+P输入Editor: Log Cursor Scope，首行输出须为source.js等正确scope；若为text.plain或text.html.vue则缺language插件，Vue中需配"source.ts": ["vue"]；语法正确但不显色时，可在styles.less中加.syntax--comment {color: #616161 !important; font-style: italic !important;}强制高亮。
多行注释高亮失效，先查语法 scope
Atom 不会自动给 /* ... */ 加高亮，除非当前文件被正确识别为对应语言的语法作用域。比如 .js 文件必须匹配 source.js，.ts 文件得是 source.ts，而 .vue 里的 <script></script> 块如果没委托成功，也会退化成 text.html.vue，导致注释不着色。
验证方法：光标停在注释内，按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Editor: Log Cursor Scope 回车。第一行输出要是 source.js 或 source.ts 这类，才说明语法解析正常。
- 若显示
text.plain或text.html.vue：缺 language 插件，比如language-javascript、language-typescript、language-vue - 若显示
source.css但文件是 .scss：需装language-sass并在config.cson中映射"source.css.scss": ["scss"] - Vue 单文件中
<script lang="ts"></script>注释不亮：确认已配置"source.ts": ["vue"]到customFileTypes
手动加 CSS 规则强制高亮注释块
即使语法识别正确，某些主题会把注释颜色压得太淡，或者完全忽略多行注释样式。直接改 styles.less 最可靠：
打开 Atom → Stylesheet…，在文件末尾追加：
.syntax--comment {
color: #616161 !important;
font-style: italic !important;
}
.syntax--comment .syntax--punctuation {
color: #9e9e9e !important;
}
注意：.syntax--comment 是 Atom 的标准注释作用域名，不是所有主题都覆盖它；加 !important 是因为主题 CSS 优先级通常更高。
- 只影响当前打开的文件类型——不同语言的注释 scope 可能不同，比如 Python 是
comment.line.number-sign，CSS 是comment.block - 改错可能导致注释变透明或消失（例如设了
color: transparent），保存后立即生效，可快速试错 - 若想区分单行
//和多行/* */，可用更细粒度选择器：.syntax--comment.syntax--block
language-todo 插件不能替代语法高亮
language-todo 只负责识别并高亮 //TODO:、/* FIXME */ 这类带关键词的注释行，它不处理普通多行注释 /* ... */ 的语法着色。两者职责不同，不能互相替代。
-
language-todo高亮依赖todo-show的关键词扫描逻辑，且默认只认严格格式//TODO:（冒号后必须有空格） - 它对
/* 这是一段说明 */完全无感，这类内容仍走.syntax--comment渲染链路 - 如果发现
/* FIXME */有高亮但普通多行注释没有，说明language-todo在工作，但基础语法高亮没配好
Vue/TSX 文件里 <script></script> 注释不亮
这是语法委托断裂的典型表现。Atom 把 .vue 当作整体文件，但内部不同区块需要各自的语言解析器支持。比如 里的注释要亮，得满足三个条件：
- 装了
language-sass（支持 scss/sass） - 在
config.cson中配置"source.css.scss": ["vue"]，让 Vue 文件的 scss 区块委托给该插件 - 重启 Atom —— 多数 language 插件注册 scope 必须重启才生效
同理，<script lang="tsx"></script> 要亮，需装 language-typescript-react（不是官方 language-typescript），并配 "source.tsx": ["vue"]。
最容易被忽略的是：哪怕配对了 scope 名，如果插件本身没启用，或者被 language-html 劫持了文件类型关联（常见于旧版插件冲突），右下角状态栏仍会显示 text.html.vue，此时所有内部区块高亮都会失效。
