Ubuntu下PHPStorm代码风格设置指南
一 设置内置代码风格与格式化
- 打开设置：依次点击 File → Settings（Ubuntu 下为 Ctrl+Alt+S）。
- 配置 PHP 代码风格：进入 Editor → Code Style → PHP，在右侧选择预设（如 PSR-12、PEAR、Symfony 等）或自定义 Tabs and Indents、Spaces、Blank Lines、Wrapping and Braces 等规则；完成后点击 Apply/OK。
- 快速格式化代码：在编辑器中使用 Ctrl+Alt+L 按当前风格自动格式化；如需对选中片段格式化，先选中再按该快捷键。
二 使用PHP_CodeSniffer进行规范检查与自动修复
- 安装检查器
- 推荐通过 Composer 全局安装：在终端执行
composer global require "squizlabs/php_codesniffer=*"
- 将可执行文件路径加入环境变量（示例为 bash）：
echo 'export PATH=$PATH:$HOME/.config/composer/vendor/bin' >> ~/.bashrc
source ~/.bashrc
- 验证安装：
phpcs --version
phpcbf --version
- 在 PHPStorm 中启用与配置
- 指定 CodeSniffer：进入 File → Settings → Languages & Frameworks → PHP → Quality Tools → Code Sniffer，在 Configuration 选择 Local，指向系统中的 phpcs 可执行文件（可通过
which phpcs 获取路径），点击 Validate 验证。
- 开启实时检查：进入 File → Settings → Editor → Inspections → Quality Tools，勾选 PHP Code Sniffer validation，在右侧 Standard 选择 PSR-2/PSR-12 等规范。
- 自动修复：在需要修复的文件或目录上右键选择 PHP Code Sniffer → Fix，或使用 Tools → Actions on Save 配置保存时自动运行 phpcbf 修复可自动修复的问题。
三 团队统一与项目级配置
- 共享代码风格：在 Editor → Code Style → PHP 中点击齿轮图标，选择 Export 导出为 .xml 并在版本控制中提交；团队成员导入该 XML 以保持一致。
- 共享检查规则：在项目根目录维护 phpcs.xml 或 ruleset.xml，并在 PHPStorm 的 Code Sniffer 配置中指定该规则文件；同时将规则文件纳入 Git 管理。
- 保存即检查/修复：启用 Actions on Save（如 Reformat code、Optimize imports、Run PHP Code Sniffer），确保提交前代码风格与规范统一。
