在 CentOS 中配置 PhpStorm 代码格式化的实用步骤
一 内置格式化与快捷键
- 打开设置：依次点击 File → Settings（macOS 为 Preferences），在左侧选择 Editor → Code Style，为 PHP 配置缩进、空格、换行等风格，点击 Apply/OK 保存。
- 快速格式化：
- 格式化整个文件：将光标置于文件内，按 Ctrl + Alt + L。
- 格式化选中代码：先选中代码片段，再按 Ctrl + Alt + L。
- 多行对齐辅助：对多行连续语句进行对齐，可用 Ctrl + Alt + Shift + J，提升可读性。
二 使用 PHP-CS-Fixer 进行标准化格式化
- 安装工具（全局）：
- 执行：
composer global require friendsofphp/php-cs-fixer
- 将全局 Composer bin 目录加入 PATH（示例为 zsh）：在 ~/.zshrc 中添加
export PATH="$HOME/.composer/vendor/bin:$PATH"，然后执行 source ~/.zshrc 使配置生效。
- 在 PhpStorm 配置外部工具（File Watcher）：
- 打开 File → Settings → Tools → File Watchers，点击 + 新建，选择自定义模板。
- 关键项建议：
- Program：
php
- Arguments：
$HOME/.composer/vendor/bin/php-cs-fixer fix "$FileName$"
- Working directory：
$FileDir$
- 触发器：勾选 Auto-save edited files to trigger the watcher（文件保存时自动执行）
- 高级选项可按需开启“触发时不显示控制台”“在错误时中止”等。
- 说明：也可在系统终端直接运行
php-cs-fixer fix 文件名 对指定文件进行格式化。
三 保存时自动格式化与宏
- 创建“保存即格式化”宏：
- 打开 File → Settings → Keymap，点击 + → Macro，录制顺序为：Ctrl + Alt + L → Ctrl + S（先格式化，再保存）。
- 为该宏分配快捷键（如 Ctrl + S 或自定义组合键），保存设置。
- 使用体验：此后每次保存文件都会自动执行格式化，减少手动触发。
四 导入团队代码风格与缩进细节
- 导入团队风格方案：
- 在 Settings → Editor → Code Style 中，点击 Scheme 下拉，选择 Import Scheme，可导入 IntelliJ IDEA code style XML 或 .jar 风格包，选择后设为当前方案并 Apply/OK。
- 缩进与对齐细项（以 PHP 为例）：
- 在 Settings → Editor → Code Style → PHP → Tabs and Indents 中设置 Tab size、Indent、Continuation indent，并选择是否 Use tab character。
- 在 Formatter 相关选项中可按需启用/禁用特定规则，以保留或统一团队既有排版风格。
