别再把 PHP 写出“个人风格”了：PSR-1 与 PSR-2 实战指南

接手过历史项目的人多半有同感：翻着满屏缩进错位的代码、拼凑痕迹明显的类命名，头痛往往比报错来得更快。团队协作不是单机练习，代码规范本质上是一套降低沟通摩擦的底层契约。PHP 生态里流传最广的 PSR-1 与 PSR-2，正是这条契约的核心。把它们吃透并落地，你的代码就能从“勉强能跑”升级为企业级可用的稳定资产。

打开一个干净的 .php 文件，PSR-1 划定的是不可逾越的底线。文件必须采用纯 UTF-8 编码且剔除 BOM 头，这是跨服务器部署时的隐形地雷，顺手处理掉能省去一半的乱码排查时间。命名空间严禁留空，必须遵循层级化的 Vendor\Project\Namespace 路径结构，这直接关系到 Composer 自动加载的命中率。类名严格采用 StudlyCaps 驼峰命名，常量全大写配以下划线，方法名走小驼峰路线。很多人容易在封装时过度暴露内部状态，规范提醒我们严格控制作用域边界，不存在的保护或私有属性坚决不留，保持类结构的干净利落。

落到日常敲键盘的节奏里，PSR-2 负责抹平书写习惯带来的视觉噪音。它最直观的作用是让代码审查回归逻辑本身。统一使用空格进行四格缩进，彻底告别 Tab 与空格的混排，Git Diff 对比时不会再出现整行高亮的幻觉。花括号的位置是新手最容易犹豫的地方：控制结构的大括号必须紧跟语句写在同一行，而类与接口的花括号则独立换行。单行文字一旦突破 120 字符，正确姿势是主动断行并让延续部分保持垂直对齐，而不是拉长横向滚动条。这些排版细节看似微小，但在多人并行开发时，统一的视觉流能让大脑快速跳过格式干扰，直切核心算法。

理论背得再熟，实际推进时依然容易卡在执行力上。指望人工肉眼校对不仅效率低下，还极易引发合并冲突。破局的关键是把校验动作前置到编辑器与流水线中。IDE 端直接加载官方 PSR 模板，开启自动保存格式化功能，让每一次敲击键盘都贴合规范。针对现有老代码库，不要试图一次性全局替换，先用 PHP_CodeSniffer 或 PHP-CS-Fixer 进行增量扫描，按需修复高危问题。现代 PHP 框架早已内置标准化脚手架，新建控制器或 Service 时自动吐出合规骨架，顺势而为比强行改造更稳妥。

写代码如同整理办公桌，整齐的初衷从来不是为了拍照好看，而是为了关键时刻不抓瞎。PSR-1 构建清晰的模块骨架，PSR-2 统一外在书写风貌，两者咬合后，代码交接、依赖重构、自动化测试的阻力都会呈指数级下降。把规范当作基础设施去铺设，而不是临时代工补救，时间复利会在后续的版本迭代中清晰显现。