VSCode开发WordPress插件时，代码不生效的根源在于本地环境同步链路断裂：插件必须置于wp-content/plugins/下一级目录才能被识别；需开启WP_DEBUG并写入debug.log定位PHP错误；Live Server插件无效，必须使用真实PHP服务器（如MAMP/XAMPP/Docker）；且务必确认VSCode已启用自动保存、禁用缓存并手动刷新对应页面。
VSCode 开发 WordPress 插件时，代码改了但浏览器不刷新、插件没生效、PHP 报错却看不到日志——这些问题根源往往不在代码本身，而在本地环境的同步链路断了。关键不是“装什么”，而是“文件怎么被 Web 服务器读到”“修改后如何触发 WordPress 加载新代码”。
WordPress 插件文件必须放在 wp-content/plugins/ 目录下才能被识别
VSCode 编辑器本身不运行 PHP，它只是编辑器；真正的执行依赖本地 Web 服务器（如 XAMPP、MAMP、Docker 或 Laravel Valet）。如果你把插件代码放在桌面或任意目录，WordPress 根本不会扫描它。
- 正确路径示例：
/Applications/MAMP/htdocs/my-site/wp-content/plugins/my-plugin/（macOS + MAMP） - 错误做法：在 VSCode 中新建一个空文件夹
~/Desktop/my-plugin，写完代码就以为能直接启用 - 验证方式：进入 WordPress 后台 → 插件页面，看是否出现你的插件名称；若没有，先检查路径是否在
wp-content/plugins/下一层 - 注意子目录嵌套：WordPress 不支持
plugins/my-plugin/v1/这种结构；主插件 PHP 文件（含Plugin Name:注释头）必须直接放在my-plugin/目录下
wp-config.php 中的 WP_DEBUG 必须开启，否则 PHP 错误静默失败
很多开发者改完代码发现插件“没反应”，其实是 PHP fatal error 导致整个插件加载中断，但默认情况下 WordPress 不显示任何报错——它只记录到日志，而你根本没去看。
- 在
wp-config.php中找到或添加：define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false); -
WP_DEBUG_LOG会把错误写入wp-content/debug.log，这是你排查问题的第一手依据 -
WP_DEBUG_DISPLAY设为false是为了防止错误信息暴露在前端页面（安全考虑），但别因此误以为“没报错” - 常见陷阱：改了
wp-config.php却忘了保存，或者改的是另一个同名文件（比如项目根目录下有个备份用的wp-config-sample.php）
Live Server 插件对 WordPress 无效，必须用真实 PHP 环境
VSCode 的 Live Server 插件只起一个静态 HTTP 服务（http-server），它不解析 PHP，也不加载 WordPress 的 bootstrap 流程。点击插件里的 “Go Live” 按钮，打开的页面永远是空白或报 500 错误。
- 正确做法：确保本地已运行 Apache/Nginx + PHP + MySQL，并通过
http://localhost/my-site/访问站点 - 开发时访问地址应为 WordPress 安装路径下的完整 URL，例如：
http://localhost/my-site/wp-admin/plugin-install.php，而不是http://localhost:5500/my-plugin/index.php - 如果用 Docker，确认容器已映射正确端口且
wp-content目录挂载为可写（否则插件启用后无法生成缓存或写入数据库） - 小技巧：在插件主文件开头加
error_log('my-plugin loaded');，然后tail -f wp-content/debug.log实时观察是否执行，比反复刷新后台更可靠
文件保存后 WordPress 不自动重载？检查插件激活状态与缓存
改完 PHP 文件并保存，WordPress 并不会“实时重读”——它只在插件被激活、且请求到达时才加载一次。所以你改了代码，但没刷新页面或没触发对应钩子，就看不到效果。
- 每次修改后，务必手动刷新前端或后台相关页面（比如你改的是 admin 页面逻辑，就刷新
/wp-admin/） - 禁用所有缓存：关闭浏览器缓存（DevTools → Network → ✅ Disable cache）、停用 WP Super Cache / Redis 等插件、清空对象缓存（
wp cache flush如果用 WP-CLI） - 某些主题或插件会预编译 PHP（如 HHVM 或 OPcache），需重启 Web 服务或执行
wp eval 'opcache_reset();' - 最易忽略的一点：VSCode 默认关闭自动保存（
files.autoSave关闭），Ctrl+S 忘按，改了等于没改
真正卡住人的地方从来不是语法或钩子写错，而是“代码改了，但根本没进 WordPress 的加载流程”。先确认路径、再开 debug、绕过 Live Server、最后盯住缓存和保存动作——这四步走完，90% 的同步问题就定位清楚了。
