phpstorm本身不带php代码规范检查能力，必须正确接入本地phpcs可执行文件并配置path、standard、config三处绑定；需终端能运行phpcs --version，路径填绝对可执行文件，选psr12等具体标准，补充squiz.commenting.functioncomment等子规则，scope设为project files并禁用缓存。
PhpStorm 本身不带 PHP 代码规范检查能力，必须把本地安装的 phpcs 可执行文件正确接入 Inspection 系统，否则波浪线永远不会出现。
确认 phpcs 命令能在终端直接运行
这是所有配置的前提——PhpStorm 不会帮你装工具，也不会报错提示你没装好，它只会静默跳过检查。
- 在终端执行
phpcs --version，有输出（如3.7.2）才算就绪 - 若报
command not found，用composer global require squizlabs/php_codesniffer全局安装，或进项目跑composer require --dev squizlabs/php_codesniffer - 查路径：macOS/Linux 执行
which phpcs，Windows 执行where phpcs，拿到的完整路径要一模一样填进 PhpStorm - 别填
phpcs或vendor/bin这类目录，必须是可执行文件本身，比如/Users/xxx/.composer/vendor/bin/phpcs或C:\Users\xxx\AppData\Roaming\Composer\vendor\bin\phpcs.bat
在 PhpStorm 中填对三个关键位置
Settings → Languages & Frameworks → PHP → Code Sniffer 页面里，三个字段缺一不可，且互相绑定：
-
Path to phpcs：必须填上一步查到的完整路径，不能留空、不能错字符、不能指向目录 -
Configuration下拉菜单：必须选一个具体标准，比如PSR12；只勾选 “Enable code sniffing” 是无效的 - 如果选了
Local configuration file，路径必须指向项目根目录下的phpcs.xml或phpcs.xml.dist，且该文件存在、格式合法、能被phpcs --config=xxx正确加载
为什么选了 PSR12 却不报 @return 缺失？
PSR12 标准本身不含文档块校验规则，@return、@param 是否存在、是否对齐、是否带类型，由 Squiz.Commenting.FunctionComment 这类 sniff 控制，它们默认不启用。
- 在
phpcs.xml里不能只写<rule ref="PSR12"></rule>，得显式加一行：<rule ref="Squiz.Commenting.FunctionComment"></rule> - 命令行验证方式：
phpcs --standard=PSR12 --sniffs=Squiz.Commenting.FunctionComment src/MyClass.php，能触发才说明规则真生效 - 缩进、空行等细节也类似：PSR12 要求方法间空两行，但默认不强制，需额外配
Squiz.WhiteSpace.FunctionSpacing并设spacing="2"
实时提示不出现？先看 Scope 和缓存
常见现象是改完设置、保存文件、甚至重启 IDE，编辑器里依然没波浪线——大概率是扫描范围太窄或缓存没清掉。
- 进入 Settings → Editor → Inspections → PHP → PHP Code Sniffer validation，把
Scope设为Project Files（不是Current File） - 在同一页面底部，取消勾选
Use cache，可解决旧缓存导致的漏报（代价是轻微变慢） - 改完
phpcs.xml后，务必点Validate按钮，看到绿色对勾才算被正确读取；报错常见于 XML 格式错误或路径不存在 - 文件编码必须是 UTF-8 无 BOM，否则
Squiz.WhiteSpace.SuperfluousWhitespace可能误判换行符，导致空行类规则失效
最常被忽略的一点：PhpStorm 的 Inspection 引擎和外部 linter（如 phpcs）是两套流程，UI 上混在一起显示，但来源不同。标黄却不带文字提示，往往是缓存残留或作用域错配，而不是规则本身没配对。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
