WP-CLI：使用终端操作 WordPress — 第 1 部分

发布: 1天前 (2026年5月4日 GMT+8 00:25)

5 分钟阅读

Source: Dev.to

Source: …

为什么使用 WP‑CLI？

别再为每个小任务在 wp‑admin 中点来点去了。WP‑CLI 是 WordPress 官方的命令行界面，让你可以在终端中更快地管理站点。
在仪表盘上执行的常规操作（更新插件、清除缓存、重置密码、执行搜索‑替换）可能需要 30 多次点击。而使用 WP‑CLI 往往只需一行命令。

它解决了哪些问题

批量操作 – 一条命令即可更新所有插件或主题。
数据库搜索‑替换 – 在迁移站点时不会破坏序列化数据。
无法登录 wp‑admin？ – 直接在 CLI 中重置密码或创建管理员用户。
重复的设置任务 – 为每个新项目自动化相同的步骤。
Cron 与计划任务 – 从服务器的 crontab 中可靠地触发 wp‑cron。

是好是坏？

诚实的回答： 对开发者来说非常棒；对从不打开终端的人来说则无关紧要。

✅ 适合以下场景

开发者工作流
管理多个站点
自动化重复任务
更快的部署

⚠️ 需要注意的地方

对破坏性数据库命令没有撤销功能
错误的路径可能影响错误的站点
需要 SSH/终端访问权限
某些共享主机可能会限制使用

黄金法则： 在生产环境执行破坏性命令前，务必先在演示/暂存环境中测试。力量是双刃剑。

设置与安装

步骤指南（Linux/macOS）

# Step 1 — Download the Phar file
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

# Step 2 — Make it executable and move it globally
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

# Step 3 — Verify the installation
wp --info

你应该能看到你的操作系统、PHP 版本和 WP‑CLI 版本。如果看到——就可以开始使用了。

替代安装方式

Composer: composer global require wp-cli/wp-cli-bundle
WSL（推荐） 适用于 Windows 用户。
LocalWP、DevKinsta、DDEV：WP‑CLI 已经捆绑，无需额外设置。

提示： 所有命令请在 WordPress 根目录下运行。

必备命令

命令	功能说明
`wp core install`	一键安装 WordPress
`wp plugin install --activate`	从 wordpress.org 安装并激活插件
`wp plugin update --all`	一次性更新所有插件
`wp theme activate <theme>`	立即切换当前主题
`wp user create <user> --role=<role> --user_pass=<pass>`	创建带角色和密码的用户
`wp search-replace 'old' 'new'`	安全的数据库搜索‑替换（处理序列化数据）
`wp db export <file>` / `wp db import <file>`	备份或恢复数据库
`wp cache flush`	清除对象缓存
`wp option get <name>` / `wp option update <name> <value>`	读取或修改 `wp_options` 的值
`wp cron event run <event>`	手动触发 WP‑Cron 事件

完整命令参考 →

实际案例：迁移站点

在转移文件并导入数据库后，运行：

wp search-replace 'localhost' 'staging.example.com' --all-tables

序列化数据会被安全处理——不会出现数组损坏，也无需手动编辑 SQL。原本需要 20 分钟的工作现在只需几秒钟即可完成。

您的第一个自定义脚本

创建一个 shell 脚本，以使用您常用的插件设置全新的 WordPress 安装。

#!/bin/bash
# setup.sh — run after: wp core download && wp config create

# Install WordPress
wp core install \
  --url=localhost \
  --title="My Site" \
  --admin_user=admin \
  --admin_email=you@dev.com

# Install & activate standard plugins
wp plugin install wordfence woocommerce yoast-seo --activate

# Set a clean permalink structure
wp rewrite structure '/%postname%/' --hard

echo "✅ Setup complete!"

将其保存为 setup.sh，使其可执行（chmod +x setup.sh），并在每次全新安装后运行它。环境一致，省时省力。

接下来

在第 2 部分我们将深入探讨：

使用 WP_CLI::add_command() 编写高级自定义 PHP 命令
在 CI/CD 流水线中使用 WP‑CLI
管理远程 WordPress 站点
使用 --dry-run 模式，确保不破坏生产环境

觉得有帮助吗？点个 ❤️，并关注第 2 部分！