VSCode开发WordPress插件：配置Localhost环境的代码同步-VSCode-PHP中文网

vscode开发wordpress插件时，代码不生效的根源在于本地环境同步链路断裂：插件必须置于wp-content/plugins/下一级目录才能被识别；需开启wp_debug并写入debug.log定位php错误；live server插件无效，必须使用真实php服务器（如mamp/xampp/docker）；且务必确认vscode已启用自动保存、禁用缓存并手动刷新对应页面。

vscode开发wordpress插件：配置localhost环境的代码同步

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 不显示任何报错——它只记录到日志，而你根本没去看。

论文常用的tex格式转换为word格式，核心是能转换数学公式（非图片），表格，图表等等

将 LaTeX（.tex）学术论文转换为 Word（.docx），支持可编辑的 OMML 公式、原生 Word 表格、嵌入图形、IEEE 双栏排版及参考文献

下载

在 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% 的同步问题就定位清楚了。