Ubuntu 系统手把手安装 WP-CLI（wp 命令）教程｜终端高效管理 WordPress

玩 WordPress 建站的小伙伴应该都知道，后台可视化操作虽然直观，但批量更新插件、主题、导入导出数据、批量修改站点配置时，操作繁琐且耗时。今天给大家分享Ubuntu 系统安装 WP-CLI（wp 命令）的完整教程，安装完成后，直接通过终端命令就能高效管理 WordPress 站点，大幅提升运维效率，适合所有 Ubuntu 主流版本（20.04/22.04/24.04）。

一、什么是 WP-CLI？

WP-CLI 是 WordPress 官方推出的命令行管理工具，安装后系统会生成 wp 全局命令。无需登录网站后台，通过服务器终端即可完成 WordPress 的安装、升级、插件/主题管理、数据库操作、用户配置、缓存清理等几乎所有运维操作，是建站、服务器运维的必备工具。

核心优势：快速、批量、自动化，支持脚本批量运维，完美适配云服务器、VPS 搭建的 WordPress 站点。

二、安装前置依赖

WP-CLI 运行需要 PHP 环境和 curl 下载工具，搭建过 WordPress 的 Ubuntu 服务器基本都已适配，新手可执行命令一键补齐所有依赖：

sudo apt update && sudo apt install curl php-cli php-mbstring php-zip -y

简单说明依赖作用：

• curl：用于下载 WP-CLI 官方安装包
• php-cli：PHP 命令行运行环境，WP-CLI 核心运行依赖
• php-mbstring、php-zip：适配插件安装、文件解压、字符编码兼容

三、Ubuntu 安装 WP-CLI 完整步骤

全程仅需 3 条核心命令，极简安装，无复杂配置，新手直接复制执行即可。

1. 下载官方 WP-CLI 安装包

通过 curl 下载官方最新版 wp-cli.phar 运行文件：

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

2. 添加执行权限

给下载的文件添加可运行权限，确保系统能够识别并执行：

chmod +x wp-cli.phar

3. 配置全局 wp 命令

将文件移动到系统全局环境目录 /usr/local/bin/，实现任意目录直接调用 wp 命令：

sudo mv wp-cli.phar /usr/local/bin/wp

四、验证安装是否成功

安装完成后，执行验证命令，查看 WP-CLI 版本及环境信息：

wp --info

若输出类似以下信息，说明安装成功：

WP-CLI version: 2.11.0 PHP version: 8.1.2 Operating system: Linux Ubuntu

如果提示 command not found，大概率是文件移动失败或权限不足，重新执行第三步全局配置命令即可解决。

五、关键权限适配（必看避坑）

很多新手安装成功后，执行 wp 命令报错、无法读写站点文件，核心原因是运行用户权限不匹配。

WordPress 站点默认运行用户为 www-data，建议切换对站点目录执行 wp 命令，避免 root 权限导致网站文件权限混乱。进入你的 WordPress 站点根目录（默认 /var/www/html）执行操作即可。

示例：进入站点目录查看 WordPress 版本

cd /var/www/html
wp core version

六、常用 wp 命令速查（新手够用）

分享日常运维高频命令，无需记复杂语法，直接复制使用：

1. 站点基础操作

# 查看WP版本
wp core version
# 升级WordPress核心
wp core update

2. 插件管理

# 查看已安装插件
wp plugin list
# 批量更新所有插件
wp plugin update --all
# 安装并启用指定插件
wp plugin install 插件名 --activate

3. 主题管理

# 查看已安装主题
wp theme list
# 更新所有主题
wp theme update --all

4. 数据库操作

# 优化数据库
wp db optimize
# 修复数据库
wp db repair

七、常见问题解决

1. curl 下载失败、超时

服务器网络问题导致下载失败，可切换国内镜像源重新下载，或多执行一次下载命令。

2. PHP 扩展缺失报错

执行前置依赖安装命令，补齐 mbstring、zip 扩展，重启 PHP 环境即可。

3. 权限拒绝、无法写入文件

禁止直接用 root 权限操作站点目录，进入站点根目录，使用 www-data 权限执行命令。

八、最后总结

WP-CLI 的安装非常简单，Ubuntu 系统全程 3 步即可完成部署。熟练使用 wp 命令后，相比后台可视化操作，站点运维效率能提升数倍，尤其适合多站点批量管理、日常批量更新维护，是 WordPress 运维的刚需工具。

后续可以搭配定时脚本，实现插件、主题、核心自动更新，数据库自动备份，彻底解放双手！