Ubuntu下phpstorm的代码格式化怎么设置

Ubuntu 下 PhpStorm 代码格式化设置

一 基础缩进与对齐

• 打开设置：File → Settings → Editor → Code Style，在顶部选择语言为 PHP（或 General 用于全局文本）。
• 在 Tabs and Indents 中设置：
  • Tab size、Indent、Continuation indent（常用为 4 空格或 1 Tab）。
  • 勾选 Use tab character 或 Use spaces（建议团队统一为空格，便于跨编辑器一致）。
• 常用对齐示例（PHP）：
  • 在 Wrapping and Braces 中勾选 Align key-value pairs，可让数组的 => 对齐。
  • 勾选 Align consecutive assignments，可让连续的 = 对齐（适合配置项、数据集合等）。
• 多行选中后可用快捷键 Ctrl + Alt + Shift + J 执行对齐，快速整理选中代码的对齐。

二 保存时自动格式化与 PHP-CS-Fixer 集成

• 内置格式化快捷键：Ctrl + Alt + L（Reformat Code）。
• 若需遵循团队 PSR 等规范，建议使用 PHP-CS-Fixer 并配置保存时自动执行：
  1. 全局安装：在项目或系统执行
     • composer global require friendsofphp/php-cs-fixer
     • 确保 $HOME/.composer/vendor/bin 已加入 PATH（如写入 ~/.zshrc 或 ~/.bashrc）。
  2. 在 PhpStorm 添加 File Watcher：
     • 打开 Settings → Tools → File Watchers，点击 +，选择 Custom。
     • Name：PHP-CS-Fixer；File type：PHP；Scope：Project Files。
     • Program：填入 which php-cs-fixer 的结果（如 $HOME/.composer/vendor/bin/php-cs-fixer）。
     • Arguments：fix $FileDir$/$FileName$（如需使用项目根目录配置，改为：fix --config=$ProjectFileDir$/.php-cs.dist $FileDir$/$FileName$）。
     • Working directory：$ProjectFileDir$；触发条件勾选 On save。
  3. 项目根目录放置 .php-cs.dist 配置文件，按团队规范配置规则（如 @PSR2、数组短语法等）。

三 常用快捷键与触发方式

• 整文件格式化：Ctrl + Alt + L。
• 多行对齐整理：Ctrl + Alt + Shift + J（适合临时对齐或微调）。

四 团队统一与导入导出配置

• 在 Settings → Editor → Code Style → PHP 右上角使用 Scheme 管理：
  • 选择 Project 使配置仅对当前项目生效；选择 Default 为 IDE 全局生效。
  • 通过 Export/Import 导出为 .xml 并在团队成员间共享，确保全组代码风格一致。