WordPress函数不识别需添加核心源码为Library；Xdebug trace失效须检查CLI php.ini配置；主题函数返回空因内置服务器无WP上下文；Composer类未找到是PSR-4路径映射错误。
WordPress项目在PhpStorm里不识别get_posts()等函数
PhpStorm默认不加载WordPress核心函数签名，所以get_posts()、the_content()这些会标红或没补全。不是你代码错了，是IDE没“认出”它们。
解决方法很简单：把WordPress源码目录作为「Library」加入项目。
- 下载官方WordPress源码（和你线上环境版本一致），解压到本地某个路径，比如
/Users/me/wp-core-6.4.3 - 在PhpStorm中：File → Settings → Directories → 点击+号 → 选择那个
wp-includes和wp-admin所在根目录 → 勾选「Mark as: Library Files」 - 重启索引（右下角弹窗点「Reload project index」，或手动 File → Reload project）
注意：别用wp-content/themes/xxx这种子目录做Library——它只含主题文件，没有核心函数定义；也别用远程zip在线加载，不稳定且补全延迟高。
调试WordPress时xdebug_start_trace()没输出
不是Xdebug没装，大概率是PhpStorm没配对PHP CLI解释器的配置文件，或者php.ini里关了trace开关。
立即学习“PHP免费学习笔记（深入）”；
检查顺序必须是：CLI的php.ini → Xdebug扩展是否启用 → trace相关参数是否放开。
- 终端执行
php --ini，确认实际加载的是哪个php.ini（常见坑：Apache用一个，CLI用另一个） - 在这个
php.ini里确保有：zend_extension=xdebug.so（macOS/Linux）或php_xdebug.dll（Windows） - 加上这两行（Xdebug 3+）：
xdebug.mode=develop,trace和xdebug.output_dir="/tmp/xdebug-trace" - PhpStorm里：Settings → PHP → CLI Interpreter → 配置好对应PHP可执行路径，并点「…」确认它读取的是上面那个
php.ini
改完记得重启PHP-FPM或Apache，再在代码里调xdebug_start_trace()——否则函数存在但静默失效。
主题开发时get_template_directory_uri()返回空或错路径
这通常发生在用PhpStorm内置Web服务器跑WordPress，而不是走真实Apache/Nginx。内置服务器不会加载WordPress的全局常量和上下文，get_template_directory_uri()依赖WP_CONTENT_DIR等定义，直接调就返回空。
正确做法是：别用PhpStorm内置Server跑WordPress整站，只用它写代码 + 调试；运行交给本地环境（Docker、Valet、XAMPP等）。
- 在PhpStorm里：Run → Edit Configurations → PHP Web Page → URL填你的本地站点地址（如
http://local.wordpress.test），不要填http://localhost:63342/... - 调试时用「PHP Remote Debug」模式，配合浏览器Xdebug Helper插件触发断点
- 如果硬要本地预览HTML片段，改用
__DIR__ . '/style.css'这类绝对路径做临时检查，但别提交到生产
强行让内置Server加载WordPress bootstrap会导致路由错乱、钩子不触发，得不偿失。
Composer自动加载vendor/autoload.php后仍报Class not found
WordPress主题/插件里用Composer管理依赖时，常见问题是require_once 'vendor/autoload.php'写了，但类还是找不到——根本原因是PSR-4映射没生效，或者composer.json里autoload配置路径写死了相对位置。
- 确认
composer.json里的autoload段用的是相对路径（如"psr-4": {"MyPlugin\": "src/"}），而非"../src/"这种越级引用 - 运行
composer dump-autoload -o强制重生成优化后的autoload map - 在PhpStorm里：右键
vendor目录 → Mark Directory as → Excluded（避免索引干扰），同时确保src/目录被标记为Sources - 如果类在
wp-content/plugins/my-plugin/src/下，而composer.json放在my-plugin/根目录，那PSR-4前缀路径就必须从src/开始算，不能带wp-content
Composer autoload本质是路径映射表，PhpStorm只是读它；表错了，IDE再聪明也没用。
