Ubuntu下PhpStorm配置代码风格的完整步骤
1. 打开PhpStorm设置入口
启动PhpStorm后，通过顶部主菜单进入配置窗口：点击File > Settings（若使用macOS系统，则点击PhpStorm > Preferences）。也可使用快捷键Ctrl+Alt+S快速调出设置面板。
2. 导航至代码风格设置
在设置窗口左侧边栏中，依次展开Editor分类，点击Code Style选项，随后在右侧面板中选择PHP标签——此处为PHP代码的专属风格配置页面。
3. 自定义基础代码风格规则
在PHP标签页下，可调整以下核心格式规则（以常见需求为例）：
- 缩进设置：取消“Use tab character”（使用制表符）的勾选，勾选“Tab and Indents”下的“Use spaces”（使用空格），并设置“Tab size”（制表符大小）和“Indent”（缩进）为4（符合PSR标准）；
- 空格规则：展开“Spaces”分类，勾选“Around operators”（运算符周围）、“Within parentheses”（括号内）等选项，确保运算符、括号等符号周围有统一空格；
- 换行规则：展开“Blank Lines”分类，设置“Keep maximum blank lines”（保留最大空行数）为1~2，避免过多空行影响代码紧凑性；
- 大括号风格：展开“Braces Placement”分类，将“Class declaration”“Method declaration”等选项设置为“End of line”（行尾），符合PSR规范的“K&R”风格。
4. 应用预定义代码规范（如PSR-2）
若需快速采用社区通用规范（如PSR-2），无需手动逐项配置：
- 在Code Style > PHP页面右侧，找到Scheme下拉菜单；
- 选择PSR-2（或“PSR-12”，若需更严格的现代规范），PhpStorm会自动加载对应规则的预设配置；
- 点击Apply（应用）→ OK（确定）保存设置。
5. 手动格式化代码
配置完成后，可通过以下方式手动触发格式化：
- 单文件格式化：在编辑器中打开PHP文件，使用快捷键
Ctrl+Alt+L（Windows/Linux）格式化当前文件；
- 选中代码格式化：选中代码块后，按
Ctrl+Alt+L可仅格式化选定部分。
6. 设置保存时自动格式化
为避免遗忘，可开启保存时自动格式化：
- 进入Settings > Editor > General > Code Completion；
- 勾选“Code Format on Save”（保存时格式化）选项；
- 点击Apply→OK，此后每次保存PHP文件时，PhpStorm会自动应用当前代码风格。
7. 高级：使用File Watcher自动执行代码格式化（可选）
若需通过外部工具（如php-cs-fixer）实现更强大的格式化，可配置File Watcher：
- 全局安装
php-cs-fixer：在终端运行composer global require friendsofphp/php-cs-fixer；
- 获取工具路径：在终端输入
which php-cs-fixer，记下输出路径（如/home/username/.config/composer/vendor/bin/php-cs-fixer）；
- 进入Settings > Tools > File Watchers，点击“+”号选择Custom；
- 配置参数：在“Program”字段粘贴
php-cs-fixer路径，“Arguments”输入fix $FilePath$，“Output paths”输入$FilePath$；
- 点击OK保存，此后保存PHP文件时会自动调用
php-cs-fixer格式化。
8. 导出/导入代码风格模板（团队协作）
若需共享代码风格设置，可导出/导入模板：
- 导出模板：在Code Style > PHP页面，点击Scheme下拉菜单旁的齿轮图标，选择Export，保存为
.icls文件；
- 导入模板：在其他项目中，通过相同路径点击齿轮图标，选择Import，加载
.icls文件即可同步风格。
