PhpStorm在Debian系统上的代码格式化设置指南
一、基础格式化设置入口
- 打开设置对话框：在PhpStorm中，通过顶部菜单选择 File > Settings（Windows/Linux通用快捷键：
Ctrl + Alt + S）。
- 导航到代码样式配置：在设置窗口左侧面板依次展开 Editor > Code Style > PHP，此处为PHP代码格式化的核心配置页面。
二、常用格式化选项配置
1. 缩进与空格调整
- 缩进单位：在Tabs and Indents标签下，设置
Tab size（Tab显示的空格数，推荐4）、Indent（代码缩进大小，推荐4）、Continuation indent（换行语句的额外缩进，推荐8）；取消勾选Use tab character可强制使用空格代替Tab。
- 空格规则：在Spaces子标签中，可配置运算符、逗号、冒号等符号前后的空格（如“Around operators”勾选表示
$a = $b + $c中的=和+两侧有空格）。
2. 换行与大括号位置
- 方法/函数声明换行：切换到Wrapping and Braces标签，找到Method declaration部分，将
Access modifier placement设置为Same line（使public与function同行），取消勾选Wrap when exceeds right margin（避免因行长自动换行），勾选Keep when reformatting下的Access modifier和Function keyword（保留格式化前的访问修饰符和函数关键字）。
- 花括号位置：在Braces placement子标签中，将
Namespace、Class、Method等选项设置为End of line（使大括号与声明同行，如function foo() {）。
3. 对齐优化
- 等号对齐：在Wrapping and Braces标签下，勾选Align consecutive assignments（对齐连续的赋值语句，如
$var1 = 1; $longVarName = 2;会自动对齐=）。
- 键值对对齐：勾选Align key-value pairs（对齐数组或参数的键值对，如
['key1' => 'value1', 'key2' => 'value2']中的=>会对齐）。
三、使用快捷键快速格式化
- 格式化整个文件：在编辑器中右键点击标签页，选择Reformat Code；或使用快捷键
Ctrl + Alt + L（Windows/Linux）。
- 格式化选中代码块：选中需要格式化的代码，右键点击选择Reformat Code，或使用相同快捷键。
四、保留原有排版的技巧
- 格式化标记：在Formatter标签下，勾选
Enable formatter markers in comments，格式化时会插入特殊标记（如// @formatter:off和// @formatter:on），用于保留手动调整的部分（如复杂的SQL语句）。
- 禁用特定规则：在Wrapping and Braces或其他子标签中，取消勾选不需要的自动格式化选项（如“Keep line breaks”可避免强制换行）。
五、导出/导入设置（团队协作）
- 导出设置：点击File > Export Settings，选择需要导出的配置（如
Code Style），保存为.jar文件，分享给团队成员。
- 导入设置：团队成员通过File > Import Settings选择导出的
.jar文件，即可同步代码格式化规则。
六、第三方格式化工具集成（可选）
若需更严格的规范（如PSR-2），可集成PHP-CS-Fixer或PHP_CodeSniffer：
- 安装插件：通过File > Settings > Plugins，搜索“PHP-CS-Fixer”或“PHP_CodeSniffer”，点击“Install”并重启PhpStorm。
- 配置工具路径：在Settings > PHP > Quality Tools中，设置工具的可执行文件路径（如
php-cs-fixer的安装路径）。
- 运行格式化：右键点击文件或文件夹，选择对应工具的“Fix”选项，即可自动格式化代码。
以上设置可根据项目需求调整，建议团队统一配置并导出共享，确保代码风格一致性。