debian环境下phpstorm如何进行代码格式化

Debian环境下 PhpStorm 代码格式化实操指南

一 快速格式化与快捷键

• 在编辑器中选中需要格式化的代码或打开目标文件，使用默认快捷键一键格式化：
  • Linux/Debian：Ctrl + Alt + L
  • macOS：Cmd + Option + L
• 若快捷键被修改或冲突：进入 File → Settings → Keymap，搜索 Reformat Code，右键 Add Keyboard Shortcut 重新绑定。以上快捷键与 Keymap 设置在 Debian 与 Windows 键位一致。

二 配置代码风格与保存时自动格式化

• 设置代码风格
  • 打开 File → Settings → Editor → Code Style → PHP。
  • 通过右上角 Set from… 选择 PSR-12 等内置规范，或点击 Manage… → Import Scheme… 导入团队 XML 风格文件；也可手动调整 Tabs and Indents、Spaces、Wrapping and Braces 等细节。
• 保存时自动格式化
  • 打开 File → Settings → Tools → Actions on Save，勾选 Reformat code，可同时按需勾选 Optimize imports 等，实现保存即规范化。

三 使用 EditorConfig 统一基础风格（推荐）

• 在项目根目录添加 .editorconfig，示例：

  root = true
  
  [*]
  charset = utf-8
  end_of_line = lf
  insert_final_newline = true
  trim_trailing_whitespace = true
  indent_style = space
  indent_size = 4
  
  [*.php]
  indent_size = 4
  

• 如未启用相关支持，可在 File → Settings → Plugins 搜索并安装 EditorConfig 插件，然后重启 IDE。EditorConfig 能统一 字符集、换行符、缩进、行尾空格 等基础风格，与 PhpStorm 代码风格设置协同生效。

四 集成 PHP-CS-Fixer 或 PHPCBF 进行标准化修复（可选）

• 安装工具（需已安装 Composer）
  • 全局安装：composer global require friendsofphp/php-cs-fixer
  • 代码检查与自动修复工具：composer global require squizlabs/php_codesniffer
• 在 PhpStorm 中配置 PHP-CS-Fixer
  • 打开 File → Settings → Languages & Frameworks → PHP → Quality Tools → PHP-CS-Fixer。
  • 指定 PHP-CS-Fixer 执行路径（可通过 which php-cs-fixer 获取），并在配置中选择或导入项目根目录的 .php-cs.dist / .php_cs 规则文件。
• 使用 PHPCBF 进行保存时自动修复（替代或配合 Reformat）
  • 在 Tools → External Tools 添加 phpcbf，参数示例：–standard=PSR12 $FileDir$/$FileName$；需要时可在 Keymap 为其绑定快捷键，或在 Actions on Save 中通过宏/外部工具实现保存即修复。