Better Comments 需手动配置关键词和符号规则：在 settings.json 中添加 better-comments.tags 自定义标签（如 BUG、OPTIMIZE），标签须大写无空格；//! 等特殊符号必须紧贴 // 无空格才生效；支持主流语言单行注释，依赖 VSCode 语言模式；团队统一效果需将配置写入项目 .vscode/settings.json。
怎么让 Better Comments 正确识别注释关键词
插件默认只高亮 // TODO、// FIXME、// HACK 这几类，但你写的 // BUG 或 // OPTIMIZE 不会变色——不是插件坏了，是没配置进关键词列表。
实操建议：
- 打开 VSCode 设置（
Ctrl+,或Cmd+,），搜“better comments” - 找到
“Better Comments: Tags”配置项，点击“Edit in settings.json” - 在
settings.json里补全自定义标签，例如："better-comments.tags": [ { "tag": "TODO", "color": "#ff8c00", "strikethrough": false, "backgroundColor": "transparent" }, { "tag": "BUG", "color": "#ff0000", "strikethrough": true, "backgroundColor": "transparent" } ] - 注意：每个
tag必须是大写纯字母，且不能含空格或符号；小写如todo不生效
// ! 和 // ? 为什么没反应
这是常见误解：插件默认启用的「特殊符号模式」只对单字符前缀（!、?、*）生效，但前提是它们**紧贴双斜杠后、无空格**，即必须写成 //! 或 //?，而不是 // !。
容易踩的坑：
-
// ! TODO→ 不触发，因为中间有空格 -
//! TODO→ 正确，会按!的配色高亮整行 - 符号颜色由
“Better Comments: Highlight Special Characters”控制，默认开，关掉就失效 - 如果用了 Prettier 或 ESLint 自动格式化，可能在保存时自动加空格，导致符号失效
不同语言里注释语法不一致，Better Comments 能用吗
能，但依赖 VSCode 当前文件的语言模式（language mode）是否被插件支持。它不是靠文件后缀判断，而是看右下角显示的当前语言标识，比如 JavaScript、Python、ShellScript。
使用场景和限制：
- 主流语言（
JavaScript、TypeScript、Python、Go、Rust）基本都支持单行注释高亮 -
HTML和CSS中的<!-- -->或/* */默认不处理，需手动在settings.json中添加commentPrefixes配置 - 某些自定义语言（如 .vue 单文件组件里的
<script>块）会继承其内部语言模式，正常工作；但<template>块里不生效 - 如果打开一个无语言关联的纯文本文件（
Plain Text），插件完全不启动
多人协作时注释颜色不一致，是配置没同步吗
不是配置问题，是插件本身不读取项目级配置——所有设置都存在用户本地 settings.json 或工作区 .vscode/settings.json 里，而后者常被忽略或未提交。
关键点：
- 团队想统一效果，必须把
better-comments.tags和better-comments.highlightSpecialCharacters显式写进项目根目录的.vscode/settings.json - 别只改自己电脑的全局设置，别人装了插件也看不到你的颜色方案
- 如果项目用了
editorconfig或 Prettier，注意它们不会影响注释高亮逻辑，但格式化行为可能破坏//!这类无空格写法 - 插件不支持通过
package.json或eslintConfig注入规则，别白费劲找这类路径
最麻烦的其实是符号和关键词混用时的优先级：插件先匹配 //! 这类符号，再 fallback 到 TODO 关键词。如果你写了 //! TODO，它只认 ! 的样式，后面的文字颜色不会叠加。这点文档不提，但实际调试时很容易卡住。
