PhpStorm全局搜索注释需用正则表达式：单行注释用^s//.$，PHPDoc用/\*\*[\s\S]*?\*/，所有注释用^\s*(//|/\*).*$/|/[sS]?*/；Search Everywhere不索引注释内容。
全局搜索 // 或 /* 开头的注释行
PhpStorm 本身没有“只搜注释”的专用入口，但可通过正则表达式精准匹配注释语法。关键不是靠功能按钮，而是用对搜索模式。
- 按
Ctrl + Shift + F（Windows/Linux）或Cmd + Shift + F（macOS）打开全局搜索 - 勾选右上角
Regex（正则表达式）复选框 - 输入以下任一模式：
— 单行注释：^s*//.*$
— PHPDoc 注释块：/**[sS]*?*/
— 所有注释（含/* ... */和//）：^s*(//|/*).*$|/*[sS]*?*/ - 点击搜索后，结果列表里每条都带上下文，能直观区分是真注释还是字符串里的伪注释（比如
echo "// not a comment";不会命中^s*//.*$）
为什么 Search Everywhere（双击 Shift）搜不到注释？
Search Everywhere 是语义索引驱动的，只查类、方法、文件、设置等可识别符号，**完全不索引注释文本内容**。它连 // TODO 都不会出现——除非你额外启用 TODO 工具窗口（Cmd + 6 / Ctrl + 6）。
- 想快速定位所有
// TODO，直接开TODO工具窗口，它专为此设计 - 想搜自定义注释如
// HACK或// FIXME，必须用上面的正则全局搜索 - 别试图在
Search Everywhere里输todo期待列出所有注释行——它只会返回叫Todo的类或文件
Find in Path 搜索时容易忽略的边界情况
即使用了正则，结果仍可能漏掉或误中，原因常出在作用域和转义上。
- 默认搜索范围是 “All Places”，但若当前项目配置了
Excluded目录（比如vendor/被排除），那些目录下的注释就搜不到——去Settings → Directories确认 -
/**[sS]*?*/在 PhpStorm 中需注意：换行符匹配依赖[sS]，不能简写成.*（后者不跨行） - 如果搜索 PHP 文件却命中了 JS 或 CSS 文件里的
//，检查右上角File mask是否设为*.php；否则默认搜所有类型 - 注释里含 Unicode 字符（如中文、emoji）时，确保正则未开启
Match case且编码无乱码（PhpStorm 默认 UTF-8，一般没问题）
替代方案：用 TODO 工具窗口管理结构化注释
如果你的注释是有模式的（如 // TODO、// FIXME），比手动正则更可持续的方式是配置 TODO 规则并使用专用窗口。
立即学习“PHP免费学习笔记（深入）”；
- 打开
Settings → Editor → TODO，点击+添加自定义模式，例如 Pattern 填FIXME:，颜色设为红色 - 之后所有匹配行自动出现在
TODO工具窗口（Cmd + 6），支持按文件、优先级、状态过滤 - 这个窗口不依赖正则执行时机，只要文件被索引，新增的
// FIXME下次保存就会立刻出现 - 注意：它只响应行首或行中带冒号的模式（
// FIXME:），不响应// fixme这种纯关键词——得靠正则
真正难的不是找到注释，而是确认它是否还在生效——比如一个 // TODO 写在已废弃的分支代码里，TODO 窗口照常显示，但没人知道它早该删了。
