必须安装JetBrains官方WordPress插件并重启IDE，否则hook补全、模板函数跳转失效；需手动指定WordPress核心路径并标记主题/插件目录为Resources Root，再配置WordPress代码样式与PHP_CodeSniffer标准。
WordPress插件必须装，否则 hook 补全和模板函数跳转全失效
JetBrains 官方的 WordPress 插件不是锦上添花，而是基础依赖。没它，add_action、get_template_part 这类函数不会被索引，wp_head 这种 hook 点不进去，get_template_directory_uri() 也无法 Ctrl+Click 跳转到定义处。
安装路径很明确：
- 打开
Settings/Preferences → Plugins - 搜索
WordPress，认准作者是JetBrains的那个 - 点
Install，然后必须点Restart IDE
别跳过重启——很多用户装完以为生效了，结果补全还是灰的，就是卡在这一步。
项目识别失败？手动指定 WordPress 核心路径是常规操作
PhpStorm 2025.1 虽然支持自动检测，但只在标准目录结构（如 wp-content/themes/ 同级存在 wp-load.php）下才可靠。本地开发用 WAMP/XAMPP 或子目录部署时，90% 会识别失败，IDE 不弹出提示，也不会启用 WordPress 支持。
立即学习“PHP免费学习笔记（深入）”；
手动补救方法：
- 进入
Settings/Preferences → Languages & Frameworks → PHP → Frameworks - 勾选
WordPress，下方出现WordPress installation path字段 - 填入你本地 WordPress 根目录的绝对路径，例如：
D:\green\wamp\www\wordpress - 确认路径下有
wp-includes/wp-db.php和wp-settings.php，否则插件不认
填完不用重启，但要等几秒让 IDE 扫描并建立索引——状态栏右下角会显示 “Indexing WordPress…”。
主题/插件目录没被识别为 Resources Root？模板文件无法解析
即使插件装了、核心路径也设对了，get_header() 还是点不进 header.php，大概率是因为 PhpStorm 不知道你的主题或插件目录是“资源根”。它默认只把项目根目录当源码起点，wp-content/themes/my-theme/ 这种子目录会被忽略。
解决方式：
- 在项目视图中右键点击你的主题或插件目录（比如
wp-content/themes/twentytwentyfour） - 选择
Mark Directory as → Resources Root - 如果目录里有
style.css（主题）或plugin-name.php（插件），IDE 会立刻开始解析模板标签和钩子
注意：这个操作是按目录做的，每个主题/插件都要单独标记；wp-content 整体标记没用，IDE 不递归识别子目录。
代码样式和 PHP_CodeSniffer 不配 WordPress 标准，等于白装
装了插件却还被 if ( $a == 1 ) 这种空格报错，说明没启用 WordPress 编码规范。PhpStorm 自带的 WordPress 代码样式和 PHP_CodeSniffer + WP Coding Standards 是两套东西，缺一不可。
快速配齐：
- 进
Settings → Editor → Code Style → PHP，点Set from → Predefined Style → WordPress - 用 Composer 安装检查工具：
composer require --dev wp-coding-standards/wpcs - 然后在
Settings → Editor → Inspections → PHP → PHP Code Sniffer validation中启用，并选中WordPress-Core标准
这步做完，echo 'hello'; 会立刻被标黄——WordPress 要求用 esc_html_e()，而不是裸 echo。很多人漏掉这个环节，以为插件装完就万事大吉，结果写出的代码根本过不了 CI。
