ThinkPHP 8.0 默认不强制遵循 PSR-12，需通过本地安装 PHP_CodeSniffer（composer require --dev squizlabs/php_codesniffer "^3.7"）、配置 phpcs.xml 限定 app/、config/、route/ 等目录并引用 PSR12 标准，结合 phpcbf 自动修复及 Git 钩子实现可执行、可验证、可落地的代码规范。
ThinkPHP 8.0 默认遵循 PSR-12 规范，并强化了框架层命名约定（如控制器必须以 Controller 结尾、模型用大驼峰且单数形式），要统一团队代码风格，不能只靠口头约定，得靠 PHP_CodeSniffer 实现可执行、可验证、可自动修复的规范落地。
安装与项目级绑定
避免全局安装导致版本冲突，所有成员都应在项目根目录执行：
- 运行
composer require --dev squizlabs/php_codesniffer，确保phpcs和phpcbf只存在于当前项目 - 验证安装：执行
./vendor/bin/phpcs --version，确认输出版本 ≥ 3.7.2（兼容 PHP 8.2+，适配 TP8.0 的严格类型提示） - 检查内置标准：
./vendor/bin/phpcs -i，确认含 PSR12 ——这是 TP8.0 推荐的基准标准，比 PSR-2 更明确访问修饰符、空行、接口命名等细节
配置适配 ThinkPHP 8.0 结构
TP8.0 目录结构（app/、app/Controller/、app/Model/、config/、route/）需被精准覆盖，同时排除框架自身和第三方包：
- 在项目根目录新建
phpcs.xml（非 .dist），内容直接指向 TP8.0 实际路径：
<ruleset name="ThinkPHP8">
<description>ThinkPHP 8.0 Coding Standard</description>
<rule ref="PSR12"/>
<file>app/</file>
<file>config/</file>
<file>route/</file>
<file>common.php</file>
<exclude-pattern>*/tests/*</exclude-pattern>
<exclude-pattern>*/vendor/*</exclude-pattern>
<exclude-pattern>*/runtime/*</exclude-pattern>
</ruleset>
- 额外补充 ThinkPHP 特有规则：在
<rule ref="PSR12"/>后加入自定义检查，例如强制控制器类名以Controller结尾（需配合自定义 sniff 或使用Generic.NamingConventions.UpperCaseClassNames并调整正则）
集成到日常开发流程
让规范“长在开发者指尖上”，而非事后补救：
立即学习“PHP免费学习笔记（深入）”；
- 在
composer.json的scripts中添加快捷命令：
"cs:check": "phpcs --report=source",
"cs:fix": "phpcbf --standard=PSR12 app/ config/ route/",
"cs:watch": "phpcs --report=full --report-file=phpcs-report.txt --report-width=120"
}
- VS Code 安装插件 PHP Sniffer，设置
"phpsniffer.executablePath": "./vendor/bin/phpcs"，保存时自动高亮违规项 - 配置 Git pre-commit 钩子：用
phpcbf自动修复可修项，再用phpcs拦截不可修项（如缺少访问修饰符），失败则中断提交
团队协同与持续校准
工具只是载体，共识才是核心：
- 首次引入时，用
phpcbf --standard=PSR12 --extensions=php ./app批量格式化历史代码，提交前做一次“风格归一” - 将
phpcs.xml纳入代码审查 checklist，新成员入职必须跑通composer cs:check才能合并 PR - 每季度回顾
phpcs-report.txt中高频警告项（如 “Missing @return tag”、“Space after comma”），针对性更新规则或补充文档示例
