应使用 ctrl+shift+f（win/linux）或 cmd+shift+f（macos）搜索整个项目中的注释，关闭“only in open files”，启用正则并用^[\s]//\sfixme等锚定行首模式精准匹配，注意语法范围与文件过滤设置。
直接搜 //、# 或 /* 就行，但得关掉 “Only in open files” 才能扫全项目，且正则要手动点亮 .* 按钮才生效。
Ctrl+F 搜不到注释？因为你没在对的地方搜
Ctrl+F 只查当前文件，哪怕你打开的是一个 500 行的 index.js，它也不会跳出这个 buffer。如果你想找整个项目里所有 // TODO，Ctrl+F 就是错的入口。
- 想搜单个文件里的注释：用
Ctrl+F（Win/Linux）或Cmd+F（macOS），输入//、#或/*即可 - 想搜整个项目：必须用
Ctrl+Shift+F（Win/Linux）或Cmd+Shift+F（macOS）调出 Find in Project 面板 - 常见失效原因：面板右上角勾选了
Only in open files—— 关掉它，否则只扫当前已打开的几个 tab
怎么精准匹配带文字的注释（比如 // FIXME）
默认搜索是纯字符串匹配，搜 FIXME 会命中 FIXME、FIXED、甚至 fixme（大小写不敏感）。要真正定位注释行，得用正则 + 语法锚点。
- 先点亮 Find in Project 面板右下角的
.*图标（或按Alt+R）启用正则 - 搜
^[\s]*//\s*FIXME：匹配行首可选空白 +//+ 可选空格 +FIXME - 搜
^[\s]*#\s*TODO：适用于 Python、Shell 等用#注释的语言 - 注意：
.默认不匹配换行符，所以不用.*FIXME这种跨行写法，除非加(?s)前缀
为什么搜 /* 没结果？可能是语法范围被过滤了
Atom 的 Find in Project 默认尊重 .gitignore 和 core.ignoredNames，而很多项目把 node_modules、dist、build 加进去了——但你写的注释可能就在某个被忽略的配置文件或临时脚本里。
- 检查面板左上角的
File/directory pattern是否为空；如果填了src/**，那config/*.js就不会被扫到 - 想强制包含某目录：在 pattern 框里写
!config/**（前面加!表示白名单） - 确认右下角状态栏显示的 grammar 是
JavaScript或TypeScript，不是Plain text—— 否则/* ... */可能根本没被识别为注释结构 - 某些语言（如 JSON）默认不支持注释，搜
/*自然无果；装language-json5才能正确高亮和索引
搜到注释后怎么快速跳转或批量处理
Find in Project 面板右侧列出所有匹配项，但点击跳转后光标停在注释开头，没法直接编辑上下文。这时候别靠鼠标点，用快捷键链更稳。
- 按
Enter在结果列表中上下移动，Tab切入编辑器内容区，再按Enter直接跳转到该处 - 想批量删所有
// TODO行：在替换框填空，查找框填^[\s]*//\s*TODO.*$（结尾$确保整行匹配），点Replace All in Project - ⚠️ 警告：
Replace All in Project不预览、不确认、不能跨文件撤回 —— 先用Find All看右侧是否只列出了你预期的文件和行数 - 如果只是想标记或归档，别改代码，用
atom-code-annotations插件加语义化注解，比散落的//更易维护
真正容易被忽略的是：Atom 搜索不区分“注释内容”和“普通字符串”，// console.log() 和 const str = "// not a comment" 都会被 // 命中。要排除后者，必须靠正则的行首锚定 ^ 和语法上下文判断，而不是依赖插件自动识别注释块。
