用途:以终端优先方式操作 WordPress,适合批量任务、脚本化和 SSH 远程执行,比 wp-admin 更安全,且不会在万行级更新时超时。
主要能力:覆盖数据库(wp db 的 export、import、query、optimize、search-replace)、核心(wp core 的 install、update、verify-checksums、version)、插件、主题、用户、文章/页面、评论、选项、缓存、Cron、配置和多站点等命令。支持 --format=json/csv/ids、--fields、--skip-plugins、--skip-themes、--quiet 等性能与输出标志。
使用方式:先做预检,运行 wp --version、wp core is-installed、wp core version;不在 WordPress 根目录时用 --path=/path/to/wordpress 或先 cd。远程可用 --ssh=user@host/path,或在 ~/.wp-cli/config.yml 配置别名(如 @prod、@staging)后执行 wp @prod plugin list。破坏性操作前先备份,例如 wp db export backup-$(date +%Y%m%d-%H%M%S).sql,或打包 wp-content/ 与备份 SQL。可用 --dry-run 预演,如 wp plugin update --all --dry-run、wp search-replace 'old.com' 'new.com' --dry-run。
限制与注意:仅检查命令和 wp db export 无需确认,其余变更命令会提示。wp db reset、wp db clean、wp site delete、不带 --reassign 的 wp user delete、批量删除管道等不可逆,需先确认并备份。序列化数据上使用 wp search-replace 应加 --precise,否则可能静默损坏。百万行级循环调用 wp 会因每次引导 WordPress 而极慢,应改用单条 SQL 或 PHP 批处理。需要插件钩子生命周期的逻辑(REST 校验、自定义文章类型注册)应写在 PHP 中而非 CLI。不要在 shell 历史中留下带密码的命令。
适用场景:站点迁移、批量插件更新与回滚、用户审计清理、CSV 内容导入、多站点运维等。参考文件位于 ${CLAUDE_SKILL_DIR}/references/,上游文档见 https://developer.wordpress.org/cli/commands/。