EP122. “WP-CLI 入门：本地一键开启命令行”

介绍 WP-CLI（WordPress Command Line Interface）——用命令行代替网页后台执行管理操作。作者坦言自己过去很长时间因为「觉得命令行很吓人」而一直不敢用，直到发现本地开发工具 Local（by Flywheel）自带一个「Open Site Shell」按钮，点一下就能打开一个已经配置好 WP-CLI 的终端，不需要自己折腾安装步骤，是新手体验命令行最低门槛的方式。演示了用命令行装/启插件，以及批量重新生成图片裁切尺寸这个网页后台做不到（或很难做）的操作。

涉及文件

无——本讲是命令行工具操作演示，不涉及修改主题/插件源代码文件。

代码实现

打开已配置好 WP-CLI 的本地终端（仅限使用 Local 本地开发工具）：

• Local 应用 → 选中站点 → Open Site Shell 按钮 → 自动打开一个已经具备 WP-CLI 访问权限的终端窗口

[截图：Local 本地开发工具界面里的 Open Site Shell 按钮]

安装并激活插件：

# 只安装
wp plugin install query-monitor

# 安装并同时激活（一步到位）
wp plugin install query-monitor --activate

# 单独激活已安装但未启用的插件
wp plugin activate query-monitor

批量重新生成所有已上传图片的裁切尺寸（新增/修改了 add_image_size() 注册的尺寸后，历史已上传的图片不会自动补生成新尺寸，要用这个命令批量补齐）：

wp media regenerate --yes

关键改动点：

• wp plugin install <slug> 里的插件名要用 wordpress.org 插件页面地址栏里那段全小写、连字符分隔的「短名」（slug），跟后台搜索插件时看到的完整显示名字不是一回事
• --activate 是很多 WP-CLI 命令都支持的「附加动作」写法，能把「安装」和「激活」合并成一步，比在后台网页里分别点两次按钮更快
• add_image_size() 在 functions.php 里新注册一个图片尺寸后，只对之后新上传的图片生效——已经上传过的历史图片不会自动补生成这个新尺寸的裁切版本，这时候如果继续用网页后台一张张重新上传太麻烦，wp media regenerate 能一次性把媒体库里所有图片都按当前注册的全部尺寸重新生成一遍
• --yes 参数是跳过交互式确认（「是否要覆盖已存在的裁切图？」），直接让命令无人值守地执行完

常见坑

• 以为改了 functions.php 里的图片尺寸定义，网站上的老图片会自动更新——不会，只有重新生成（wp media regenerate）或重新上传，历史图片才会补出新尺寸的版本
• 觉得命令行工具门槛很高、迟迟不敢尝试——用 Local 本地开发工具自带的「Open Site Shell」是最省心的入门方式，不需要自己处理任何环境配置

延伸 / 后续讲座会用到

本讲只展示了 WP-CLI 能力的很小一部分（安装/激活插件、重新生成媒体尺寸），官方文档（wp-cli.org）还覆盖了缓存、维护模式、更新核心、定时任务等几乎所有后台能做的操作对应的命令版本，可按需查阅。线上正式服务器要用 WP-CLI 的话需要额外确认主机是否已安装（DreamHost 在 Section 21 已确认预装好）。

Sources

Udemy：

• Become a WordPress Developer: Unlocking Power With Code — Section 22, EP122