PhpStorm 在 Ubuntu 的代码格式化设置
一 基础缩进与对齐
- 打开设置：依次进入 File → Settings → Editor → Code Style，在顶部选择语言为 PHP。
- 在 Tabs and Indents 中设置：
- Tab size、Indent、Continuation indent（常用为 4 空格或按团队规范）。
- 选择 Use tab character 或 Use spaces 保持全项目一致。
- 常用对齐选项（按需启用）：
- Align key-value pairs（数组键值对按 => 对齐）。
- Align consecutive assignments（连续赋值按 = 对齐）。
- 保存后，使用 Ctrl + Alt + L 对当前文件或选区进行格式化。以上路径与选项在 Ubuntu 与 Windows/macOS 一致。
二 代码风格细节与保存时自动格式化
- 代码转换（PHP 风格）：在 Settings → Editor → Code Style → PHP → Code Conversion 中可勾选
- Force short declaration style（将 array() 自动转换为 []）。
- Add a comma after last element in multiline array（多行数组尾部自动加逗号）。
- 保存时自动格式化：在 Settings → Editor → General → Auto Import 下启用 Optimize imports on the fly（导入优化），并在 Settings → Editor → General 勾选 Save files on frame deactivation 与 Save files automatically if application is idle for X seconds，配合 Reformat code on save 可实现保存即按规则格式化（不同版本入口可能略有差异，名称接近）。
- 若需对选中多行做快速对齐，可用 Ctrl + Alt + Shift + J 提升局部整洁度。
三 使用 PHP-CS-Fixer 统一团队规范
- 安装 PHP-CS-Fixer（全局或项目内）：
- 参考项目地址：https://github.com/FriendsOfPHP/PHP-CS-Fixer
- 在 PhpStorm 启用外部工具：
- 打开 Settings → Tools → External Tools，新增工具，配置：
- Program：/usr/local/bin/php-cs-fixer（根据实际路径）
- Arguments：fix “$FilePath$” --rules=@PSR12
- Working directory：$ProjectFileDir$
- 之后可通过右键文件/目录执行，或在 File Watchers 中配置保存时自动运行，以 PSR-12 等规范统一格式。
- 提示：若团队已有 .php-cs-fixer.php 配置，请在 Arguments 中指向该配置。
四 快捷键与常见问题
- 常用快捷键（Ubuntu 常见键位）：
- Ctrl + Alt + L：格式化代码
- Ctrl + Alt + I：自动缩进
- Ctrl + /、Ctrl + Shift + /：单行/多行注释
- 若与系统快捷键冲突（如 Ctrl + Alt + L 被系统接管），可在 Settings → Keymap 中搜索 Reformat Code 重新绑定。
- 多行选择对齐：使用 Ctrl + Alt + Shift + J 对选中行做对齐整理。
- 若格式化未生效，检查当前文件类型是否为 PHP，以及是否选择了正确的 Code Style Scheme（项目/IDE）。