右键菜单中Reformat Code为灰色，是因为PhpStorm拒绝在非源码根目录（如vendor、node_modules）、未标记为Sources Root的文件夹或无PHP文件的路径执行格式化；需右键目录→Mark Directory as→Sources Root或在Project Structure中配置源码根。
直接右键文件夹 → Reformat Code，只要它不是 node_modules、dist 或未标记为源码根目录（Sources Root）的路径，就能立刻批量格式化整个文件夹及其子目录下的所有 PHP 文件。
为什么右键菜单里 Reformat Code 是灰色的？
这不是功能被禁用了，而是 PhpStorm 拒绝在“不安全”的位置执行格式化：
- 你右键点的是
vendor、node_modules、build这类非源码目录 —— 它们默认不参与代码风格处理 - 目标文件夹没被识别为源码根（Sources Root），比如只是普通文件夹，没加过
Mark Directory as → Sources Root - 该目录下压根没有 PHP 文件，或文件后缀不被识别（如
.inc、.module），PhpStorm 会跳过
临时解法：右键目录 → Mark Directory as → Sources Root；长期建议在 File → Project Structure → Modules 中确认源码根配置正确。
Reformat Code 对话框里哪些选项必须留意？
弹出窗口不是摆设，勾错一项就可能删掉 import、打乱注释分组、甚至改坏字符串内容：
立即学习“PHP免费学习笔记（深入）”；
- 务必勾选
Optimize imports：自动删无用use、补缺失项、按字母排序（对 PSR-12 合规很关键） - 慎用
Do not keep line breaks：它会抹掉你手动加的所有空行，包括函数间分隔、注释区块上下留白 - 如果只想处理 PHP 文件，点右上角
Filter→ 输入*.php；想排除测试文件，写!*.test.php或!tests/** -
Search in comments和Search in strings默认关着——别开，否则可能把注释里的 JSON 或 SQL 格式也强行重排
为什么格式化后还是 PSR-2 风格，不是 PSR-12？
因为 PhpStorm 的格式化行为完全绑定到 Settings → Editor → Code Style → PHP 的当前配置，而不是你心里想的“应该用 PSR-12”：
- 检查右侧预览区是否真有规则（比如
Brace style是Next line而不是None） - 点击右上角
Set from… → Predefined style → PSR-12，不是 PSR-2，也不是 “PHP Built-in” - 如果项目根目录有
.editorconfig，它只控制缩进/换行符/末尾空格，不控制括号位置、运算符空格、return 换行等 PSR-12 核心项 —— 这些仍由 PhpStorm 的 Code Style 决定 - 文件顶部存在 BOM 字节（尤其 Windows 下 UTF-8-BOM 保存的文件），会导致解析失败，降级为安全缩进模式；可在
Settings → Editor → File Encodings勾选Transparent native-to-ascii conversion并重开文件
最常被忽略的一点：Reformat Code 不读 .php-cs-fixer.php，也不管 phpcs.xml。如果你团队实际靠 php-cs-fixer 保准风格，就得关掉 PhpStorm 内置格式器，或用 File Watchers 替代 —— 否则 Ctrl+Alt+L 和保存时触发的格式化，永远和 CI 流水线结果对不上。
