Debian上PHPStorm代码格式化设置指南
一 内置格式化与快捷键
- 打开设置：依次进入 File → Settings → Editor → Code Style，在 Tabs and Indents 中设置 Tab size、Indent、Continuation indent 以及是否 Use tab character，用于统一缩进风格。
- 快速格式化：在编辑器中按 Ctrl + Alt + L 对当前文件或选区进行格式化。
- 多行对齐辅助：使用 Ctrl + Alt + Shift + J 对选中的多行执行对齐，提升排版整洁度。
- 保存时自动格式化：在 Settings → Tools → Actions on Save 勾选 Reformat code，可让每次保存自动执行内置格式化（适合统一团队缩进、空格等基础风格）。
二 PHP语言专属风格设置
- 路径：File → Settings → Editor → Code Style → PHP。
- 等号与键值对对齐：在 Wrapping and Braces 中勾选 Align consecutive assignments（等号对齐）与 Align key-value pairs（=> 对齐），提升可读性。
- 数组语法与尾逗号：在 Code Conversion 中勾选 Force short declaration style（将 array() 自动转换为 []）与 Add a comma after last element in multiline array（多行数组尾部逗号），保持现代 PHP 风格。
- 方案作用域：在 Scheme 处选择 Default（全局生效）或 Project（仅当前项目生效），便于在不同项目间复用或隔离风格。
三 与PHP-CS-Fixer集成实现保存即格式化
- 安装工具：在 Debian 终端执行
- 全局安装：composer global require friendsofphp/php-cs-fixer
- 若命令未找到，将全局 vendor 的 bin 目录加入 PATH，例如在 ~/.zshrc 或 ~/.bashrc 中添加：
- echo ‘export PATH=“$HOME/.composer/vendor/bin:$PATH”’ >> ~/.zshrc
- 在 PHPStorm 配置外部工具：
- 打开 Settings → Tools → File Watchers，点击 + 添加 Custom 观察器：
- Name：PHP-CS-Fixer
- File type：PHP
- Scope：Project Files
- Program：填入 which php-cs-fixer 的输出路径
- Arguments：fix $FileDir$/$FileName$
- Working directory：$ProjectFileDir$
- 勾选 Trigger the watcher on external changes（文件保存时触发）
- 使用项目本地配置：若项目根目录有 .php-cs.dist，将 Arguments 改为：
- fix --config=$ProjectFileDir$/.php-cs.dist $FileDir$/$FileName$
- 说明：PHPStorm 没有内置“保存时运行 PHP-CS-Fixer”的开关，借助 File Watcher 即可实现保存即按 PHP-CS-Fixer 规则自动格式化。
四 导入导出与团队统一
- 导出/导入代码风格：在 File → Export Settings / Import Settings 中导出或导入包含 Code Style 的配置文件，便于在多个环境或同事之间快速共享统一风格。