PhpStorm配置PHP_CodeSniffer时无Custom选项如何解决

问题复现场景 #

• 运行环境：Windows端通过WSL2g启动PhpStorm
• 故障位置：配置路径 Editor > Inspections > PHP > Quality Tools > PHP CodeSniffer validation 下的编码标准选择栏
• 故障表现：下拉列表无文档标注的「Custom」选项，无法指定自定义.xml编码规则文件
• 已尝试无效操作：重置IDE设置、执行Invalidate Caches缓存清理、运行IDE修复工具，且上述操作未清空已配置的自定义解释器等关联设置
  

根因说明 #

该问题属于WSL远程运行场景下的PhpStorm配置逻辑限制：当PHP_CodeSniffer绑定的是WSL环境内的可执行文件时，2022.3之前版本的PhpStorm不会在Inspections子配置页直接展示Custom规则入口，且常规缓存、设置重置操作不会覆盖远程解释器绑定的质量工具配置缓存，因此常规修复手段无效。

修复步骤 #

1. 先进入 Settings > PHP > Quality Tools > PHP_CodeSniffer 配置页，选中你当前使用的WSL环境对应的PHP_CodeSniffer配置项，点击路径旁的Validate按钮，确认IDE可正常读取phpcs版本信息，无路径权限报错
2. 在该配置页直接找到「Coding standard」下拉选择栏，此处即可看到缺失的Custom选项，选中后填入WSL文件系统内自定义规则xml文件的绝对路径（不要使用Windows盘符格式路径，需填写类似 /home/用户名/项目目录/phpcs.xml 的WSL路径格式）
3. 保存主配置页设置后，再返回Inspections下的PHP CodeSniffer validation配置页，此时下拉栏会同步显示已配置的自定义规则，选项缺失问题解决
4. 若操作后仍不显示，关闭PhpStorm，手动删除WSL用户目录下的PhpStorm缓存目录（默认路径为 ~/.cache/JetBrains/PhpStorm<对应版本号>/），重启IDE后重新配置即可，该操作不会损坏本地项目文件。

补充说明：2022.3之前版本的PhpStorm对WSL环境下的质量工具自定义规则配置存在已知Bug，直接升级到2022.3及以上稳定版本可直接修复该问题，无需额外调整配置。

内容的提问来源于stack exchange，提问作者Patrick Decoster