Ubuntu下PHPStorm如何设置代码风格

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），确保提交前代码风格与规范统一。