phpstorm批量格式化php代码需先配置php代码样式规则，再按文件、目录、作用域或快捷键精准执行：一设规则（如psr-12）、二选文件、三选目录、四建作用域、五用快捷键（ctrl+alt+l等）。
如果您在PhpStorm中需要对大量PHP代码进行统一风格的排版，但不确定如何控制格式化范围或自定义规则，则可能是由于未正确配置代码样式或未选择目标区域。以下是实现精准批量格式化的具体操作步骤：
一、设置全局PHP代码样式规则
该步骤用于定义PhpStorm默认应用的缩进、空格、换行等格式化行为，所有后续批量格式化操作均基于此配置生效。
1、点击顶部菜单栏 File → Settings（Windows/Linux） 或 PhpStorm → Preferences（macOS）。
2、在左侧导航栏中依次展开 Editor → Code Style → PHP。
立即学习“PHP免费学习笔记（深入）”；
3、在右侧面板中切换至 Tabs and Indents 选项卡，设置 Tab size、Indent 和 Continuation indent 数值（如统一设为4）。
4、切换至 Wrapping and Braces 选项卡，勾选 Ensure right margin is not exceeded 并设定 Right margin (columns)（如120）。
5、点击右下角 Set from… → Predefined style → PSR-12 可快速应用主流PHP规范，或手动调整后点击 Apply。
二、对指定文件批量格式化
此方法适用于需对项目中多个独立PHP文件执行统一格式化，且不涉及目录结构或特定代码块筛选。
1、在项目视图（Project Tool Window）中按住 Ctrl（Windows/Linux）或 Command（macOS） 键并单击选择多个 .php 文件。
2、右键点击任意一个已选文件，在弹出菜单中选择 Reformat Code。
3、在弹出的对话框中确认 Run for selected files only 已启用，并勾选 Optimize imports 和 Rearrange code（可选）。
4、点击 Run，PhpStorm将按当前PHP代码样式规则处理全部选中文件。
三、对整个目录递归格式化
该方式会遍历指定目录下所有符合条件的PHP文件（包括子目录），适合重构旧项目或统一团队代码风格。
1、在项目视图中右键点击目标文件夹（如 app/ 或 src/）。
2、从上下文菜单中选择 Reformat Code。
3、在弹出窗口中确保 Search in comments 和 Search in strings 处于关闭状态，避免误改注释与字符串内容。
4、勾选 Process test sources（若需同时处理 tests/ 目录则启用）。
5、点击 Run 开始批量处理，进度条显示于底部状态栏。
四、按作用域（Scope）限定格式化范围
使用自定义作用域可精确控制哪些文件参与格式化，例如仅处理“未提交至Git的修改文件”或“特定命名模式的类文件”。
1、点击顶部菜单 File → Settings → Project → Scopes（macOS为 Preferences → Project → Scopes）。
2、点击右上角 + 按钮，选择 Local 创建本地作用域。
3、输入作用域名称（如 Modified PHP Files），在表达式框中输入：file:*.php && changed。
4、点击 OK 保存作用域，返回主界面后右键任意位置，选择 Reformat Code。
5、在弹窗中点击 Show scopes 下拉列表，选择刚创建的作用域，再点击 Run。
五、通过快捷键触发当前文件或选区格式化
该方法提供最快速的局部响应，适用于编辑过程中即时修正格式，支持光标所在行、选中文本块或整个文件三种粒度。
1、将光标置于PHP文件内，不选中任何文本：按下默认快捷键 Ctrl + Alt + L（Windows/Linux） 或 Cmd + Option + L（macOS） 即格式化全文。
2、用鼠标拖选一段PHP代码（如某个函数体），再执行相同快捷键，仅该选区被重排。
3、若需强制忽略某段代码不被格式化，可在其前后添加特殊注释：// @formatter:off 与 // @formatter:on。
4、在 Settings → Keymap 中可搜索 Reformat Code 查看并修改绑定快捷键。
