WP-CLI 完整指南：WordPress 命令行界面 2026

什么是 WP-CLI？为什么开发者离不开它

WP-CLI（WordPress Command Line Interface）是 WordPress 的命令行界面工具，允许您通过终端或 SSH Shell 管理 WordPress，完全绕过图形化的管理后台。借助 WP-CLI，您可以安装插件、删除网站、批量替换数据库中的 URL，以及对 WordPress 进行深层级的数据库操作，无需打开任何网页后台界面。

WP-CLI 最大的优势在于速度和效率，比管理后台快 10 倍甚至更多，因为它不需要加载 HTML、CSS、JavaScript 或图片资源。例如更新 50 个插件，WP-CLI 只需 10 秒，而管理后台可能需要 5-10 分钟。对于需要同时管理多个 WordPress 站点的开发者和系统管理员而言，WP-CLI 是不可或缺的工具。

开发者、系统管理员和高级站点管理员经常使用 WP-CLI，因为它支持批量操作——一次处理大量任务。无论是批量搜索替换整个数据库中的 URL、导出 WordPress 配置报告，还是快速备份数据库，WP-CLI 都能高效完成，无需依赖插件或控制面板。

在 Linux VPS 上安装 WP-CLI（使用 DirectAdmin 控制面板）

WP-CLI 不会随 WordPress 或 DirectAdmin 一起预装，需要通过 SSH 手动安装到服务器上。整个过程非常简单，仅需 1-2 分钟即可完成。

第一步：SSH 登录到您的 VPS

使用 SSH 客户端（PuTTY、Terminal 或 iTerm）以 root 用户或具有 sudo 权限的用户登录服务器。

ssh root@[您的VPS-IP] 或 ssh [用户名]@[您的VPS-IP]

第二步：下载并安装 WP-CLI

执行以下命令下载 WP-CLI 并将其放置到 /usr/local/bin/ 目录：

• curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
• chmod +x wp-cli.phar
• sudo mv wp-cli.phar /usr/local/bin/wp

第三步：验证安装

运行 wp --version 确认安装成功。输出应显示类似 WP-CLI 2.10.0 的版本号。

WP-CLI 基础命令——安装、更新和管理 WordPress

安装完成后，您可以使用各种命令管理 WordPress。以下是最常用的命令列表。

WordPress 核心命令

这些命令用于管理 WordPress 核心（WordPress 本身）：

• wp core version — 查看当前 WordPress 版本
• wp core update — 将 WordPress 更新至最新版本
• wp core update-db — 核心更新后执行数据库升级
• wp core verify-checksums — 验证 WordPress 核心文件是否被篡改（用于检测入侵）
• wp core config — 自动生成 wp-config.php 配置文件

插件命令

这些命令用于管理插件：

• wp plugin list — 列出所有插件及其状态（已启用/已禁用）
• wp plugin install hello-dolly — 安装插件（名称须与仓库一致）
• wp plugin activate hello-dolly — 启用插件
• wp plugin deactivate hello-dolly — 禁用插件
• wp plugin delete hello-dolly — 删除插件
• wp plugin update --all — 一键更新所有插件
• wp plugin search woocommerce — 在 WordPress.org 仓库搜索插件

主题命令

这些命令用于管理主题：

• wp theme list — 列出所有主题
• wp theme install twentytwentyfour — 安装新主题
• wp theme activate twentytwentyfour — 启用主题
• wp theme update --all — 更新所有主题
• wp theme delete twentytwentythree — 删除未使用的主题

用户命令

这些命令用于管理 WordPress 用户：

• wp user list — 列出所有用户
• wp user create username [email protected] --role=editor — 创建指定角色的新用户
• wp user delete username — 删除用户
• wp user set-role username administrator — 修改用户角色
• wp user list --field=user_login — 仅显示所有用户的用户名

搜索替换——迁移站点时更换 URL

WP-CLI 最实用的命令之一是 wp search-replace，可以快速搜索并替换整个 WordPress 数据库中的文本。在将 WordPress 从旧域名迁移到新域名时，此命令尤为重要。

示例：将主页 URL 从 old-domain.com 替换为 new-domain.com

wp search-replace 'https://old-domain.com' 'https://new-domain.com'

执行此命令后，WP-CLI 会自动在数据库（文章、页面、HTML 内容中的链接等）中查找旧 URL 并替换为新 URL，比管理后台使用插件或手动修改快得多。

其他示例

• wp search-replace 'oldtext' 'newtext' — 搜索替换普通文本
• wp search-replace 'old' 'new' --dry-run — 预演替换，不实际保存更改
• wp search-replace 'old' 'new' --global-tables — 在所有 WordPress 表中执行替换（多站点）

数据库备份——导出与恢复数据库

WP-CLI 提供简便的数据库备份和恢复命令，在对 WordPress 进行任何重大更改前，备份是必不可少的步骤。

将数据库导出为 SQL 文件

wp db export /home/backups/wordpress-backup-$(date +%Y-%m-%d).sql

此命令将 WordPress 数据库导出到 /home/backups/ 目录下的 SQL 文件，文件名包含日期（如 wordpress-backup-2026-06-21.sql）。

从 SQL 文件导入数据库

wp db import /home/backups/wordpress-backup-2026-06-21.sql

此命令从 SQL 备份文件恢复数据库。

其他数据库命令

• wp db show-tables — 列出数据库中所有的表
• wp db query "SELECT COUNT(*) FROM wp_posts" — 执行自定义 SQL 查询
• wp db repair — 修复损坏的数据库
• wp db optimize — 优化数据库（碎片整理）

定时任务（Cron Jobs）——定时自动执行任务

WordPress 内置了 Cron 系统，用于执行计划任务（如自动更新、备份、清理等）。WP-CLI 让您轻松测试和管理这些定时任务。

查看所有计划任务

wp cron event list

此命令显示 WordPress 中所有计划任务及其下次执行时间。

立即执行指定任务

wp cron event run wp_scheduled_auto_core_update

无需等待计划时间即可立即测试 Cron 任务。

多站点命令——管理 WordPress Multisite

如果您使用 WordPress Multisite（多个站点共享同一套 WordPress 程序），WP-CLI 提供了专用命令进行管理。

多站点常用命令

• wp site list — 列出 Multisite 网络中的所有站点
• wp site create --slug=newsite --title='New Site' — 创建新子站点
• wp site delete 2 — 删除指定 ID 的站点
• wp site empty 2 — 清空站点内容（保留数据库结构）
• wp site list --field=domain — 仅显示所有站点的域名

批量操作——一次完成大量任务

WP-CLI 的核心优势在于批量操作——通过 Shell 脚本一次执行大量任务。

示例：删除所有文章

wp post delete $(wp post list --post_type=post --format=ids) --force

此命令先获取所有文章的 ID，然后批量删除，这在管理后台需要逐页手动操作。

示例：启用所有插件

wp plugin activate --all

示例：一键更新 WordPress 核心、插件和主题

wp core update && wp plugin update --all && wp theme update --all

WP-CLI 与 WordPress 管理后台速度对比

以下是 WP-CLI 与管理后台在常见任务上的速度比较：

任务	WP-CLI 耗时	管理后台耗时	速度优势
更新 WordPress 核心	5 秒	2-3 分钟	快 30 倍
更新 10 个插件	10 秒	3-5 分钟	快 20 倍
删除 100 篇文章	15 秒	10-15 分钟	快 40 倍
全库搜索替换 URL	5 秒	2-5 分钟（需插件）	快 25 倍
安装 20 个插件	20 秒	10-15 分钟	快 35 倍
备份数据库	3 秒	5-10 分钟（需插件）	快 100 倍

由此可见，WP-CLI 根据任务类型比管理后台快 20-100 倍，尤其是批量操作。WP-CLI 也更加稳定，不会因浏览器超时或页面刷新而中断。

Shell 脚本——自动化您的工作流

您可以编写 Bash Shell 脚本来自动化 WP-CLI 命令，例如：

示例：每日备份脚本

#!/bin/bash
DATE=$(date +%Y-%m-%d)
wp db export /home/backups/wp-backup-$DATE.sql
echo "Backup completed: /home/backups/wp-backup-$DATE.sql"

将此脚本设置为每日 Cron 任务（如凌晨 2 点运行），可实现数据库自动每日备份。

示例：一键更新脚本

#!/bin/bash
wp plugin update --all
wp theme update --all
wp core update
wp core update-db
echo "WordPress updated successfully"

此脚本安全地更新 WordPress 核心、插件和主题，并同时执行数据库升级。

WP-CLI 的优缺点

WP-CLI 功能强大，但并非适合所有人。以下是您需要了解的优缺点：

优点

• 速度：比管理后台快 10-100 倍
• 批量操作：一次处理大量任务
• 自动化：可编写脚本实现自动化流程
• 远程管理：通过 SSH 从任何地方管理 WordPress
• 免费开源：无任何授权费用
• 官方支持：由 Automattic（WordPress.com 团队）开发和维护

缺点

• 需要 SSH 访问：部分共享主机不提供 SSH 权限
• 学习曲线：需要具备基本的命令行操作知识
• 需手动安装：不随 WordPress 预装
• 无图形界面：需要记忆命令，无可视化操作界面
• 操作风险：命令输入有误可能造成数据损坏