todoreview 安装后无反应，90%因未成功安装或未启用；需通过命令面板确认安装、重启sublime、确保项目模式与utf-8编码、正确配置patterns正则（双反斜杠）、保存文件后再扫描。
TodoReview 安装后没反应？先确认是否真装上了
插件没生效，90% 是因为没装成功，或者装了但没启用。TodoReview 不像 PlainTasks 那样自带语法支持，它纯靠扫描文件内容，不依赖文件扩展名，但必须确保安装路径正确。
- 用
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）打开命令面板，输入Package Control: List Packages，回车后搜TodoReview—— 如果没出现，说明根本没装上 - 别手动克隆到
Packages目录后就以为完事：Sublime 会把同名目录优先加载为“已禁用插件”，得进Preferences → Package Settings → TodoReview → Settings – User确认配置存在且非空 - 装完必须重启 Sublime（不是仅关闭标签页），否则部分插件的命令注册不会触发
执行 TodoReview: Project Files 却搜不到 TODO？检查项目模式和编码
TodoReview 只在「项目模式」下工作，且默认只扫 UTF-8 编码文件。它不读取当前打开的单个文件，也不管你有没有保存——只认 File → Open Folder… 加载的根目录。
- 左下角状态栏必须显示路径（如
/home/user/myapp/），否则TodoReview: Project Files命令会静默失败，无报错、无结果 - 右下角编码必须是
UTF-8；如果显示Western (ISO 8859-1)或其他，选File → Reopen with Encoding → UTF-8，否则中文 TODO 或带 Unicode 的注释直接被跳过 - 默认 pattern 是
TODO:，注意冒号是硬性要求；若你代码里写的是TODO（无冒号）、FIXME或TESTME，得改配置里的patterns
想搜 FIXME 或自定义关键词？改 patterns 别动 pattern_names
TodoReview 的关键词匹配靠正则驱动，但配置项命名容易误导：真正起作用的是 patterns 字典，而不是 pattern_names 数组。后者只是用来生成 scope 名（比如 keyword.other.todo），不影响是否匹配。
- 打开
Preferences → Package Settings → TodoReview → Settings – User，填入：
{
"patterns": {
"todo": "(?i)\bTODO\b",
"fixme": "(?i)\bFIXME\b",
"testme": "(?i)\bTESTME\b"
}
}
- 每个 key（如
todo）对应一个 scope 名前缀，value 是正则；(?i)表示忽略大小写，\b是单词边界，防误匹配TODO_LIST - 别删掉默认的
"todo": "(?i)TODO:"，否则TODO:就失效了；新增条目不会覆盖，而是叠加扫描 - 正则里所有反斜杠必须双写（
\b），因为 JSON 字符串要转义一次，Sublime 再解析一次
搜到了但高亮不显色？这不是 TodoReview 的问题
TodoReview 本身不控制颜色，它只给匹配文本打上类似 keyword.other.todo 这样的 scope。能否显示颜色，完全取决于你当前主题是否定义了该 scope 的样式。
- 换主题最快验证：打开
Preferences → Color Scheme，切到Monokai或Ayucia，立刻能看到高亮 - 不想换主题？那就别指望 TodoReview “画颜色”，老实用
Highlight插件覆盖——它直接写死颜色值，不依赖 theme - 如果连
keyword.other.todoscope 都没打上去，检查patterns正则是否写错（比如漏了(?i)导致大小写敏感），或文件是否被file_exclude_patterns排除了
最常被忽略的一点：TodoReview 不扫描未保存的标签页，哪怕你刚写了 // TODO: fix this 并没存盘，它就当不存在。改完记得 Ctrl+S 再运行命令。
