用途：wp-env（@wordpress/env）用于搭建、配置与排查本地 WordPress 开发环境，适合开发插件、主题或核心代码。当项目已含 .wp-env.json、需要真实 MySQL、需要在环境内执行任意命令，或用户明确要求 wp-env/Docker 时使用。快速临时环境可优先考虑 Playground，无需 Docker。
主要能力：零配置自动扫描当前目录并识别插件、主题或核心；用 .wp-env.json 配置 core、phpVersion、plugins、themes、port、multisite、phpmyadmin、config、mappings、lifecycleScripts；支持 .wp-env.override.json 本地覆盖（仅 config 与 mappings 合并，其余字段整体替换）；在容器（mysql、wordpress、cli、composer、phpmyadmin）中运行 WP-CLI、PHPUnit 与命令；提供停止、重置、日志、状态、清理、销毁等管理命令；支持 Xdebug 调试、profile、trace、coverage 等模式，IDE 监听 9003 端口。
使用方式：确认 Docker 运行（docker info）与 Node.js ≥18.12.0（node -v）。安装：npm -g install @wordpress/env，或项目内 npm i @wordpress/env --save-dev 后用 npx wp-env start。启动 wp-env start，默认地址 http://localhost:8888/wp-admin/，用户名 admin，密码 password。常用参数：--update、--xdebug、--xdebug=profile,trace、--auto-port。运行命令：wp-env run cli wp plugin list；指定目录：wp-env run cli --env-cwd=wp-content/plugins/my-plugin composer install；传参：wp-env run cli php -- --version。
限制：需要 Docker 与符合要求的 Node.js；WordPress.org 插件/主题须用完整 ZIP URL，裸 slug 不可用；Xdebug 需 IDE 正确配置端口与 pathMappings；override 文件仅部分字段合并；Playground 运行时为实验性，功能有限（改用 SQLite，去掉 wp-env run 与独立测试环境）。失败常见原因包括 Docker 未启动、端口占用、源字符串无效、缓存卷过期、数据库损坏等。