如果你是macOS用户，又偏爱用终端高效操作，那Laravel Valet绝对是你的本地开发神器——它不依赖臃肿的虚拟容器，直接运行在系统层面，仅占用7MB左右内存，默认集成Nginx、PHP、DnsMasq，还能自动配置wpzhan.com域名，让你随手就能搭建起WordPress开发环境。
再搭配WP-CLI命令行工具，创建站点、导入数据、更新插件等操作都能一键完成，彻底告别图形界面的繁琐操作。这篇指南整合了2025年最新官方方案，修正了旧文档中的过时命令（比如Homebrew安装脚本、PHP版本配置等），一步步教你从环境准备到最终可用，全程终端操作，简洁又高效。
适用环境：macOS Ventura及以上版本（Sonoma完全兼容），全程使用终端操作，无需图形界面辅助。
先搞懂核心工具：为什么选Valet + WP-CLI？
相比MAMP、XAMPP这类重型集成环境，Valet的优势在于「轻量」和「自动」：
- 轻量不占用资源：无需启动虚拟机器，后台服务仅占少量内存，适合低配Mac或同时运行多个开发环境的场景；
- 自动配置省心：安装后自动启动Nginx和DnsMasq，所有wpzhan.com后缀的域名都会自动指向本地，不用手动配置hosts；
- 兼容性强：原生支持WordPress，还能适配Laravel、Drupal等多种PHP项目，一套环境搞定多类开发需求。
而WP-CLI则是WordPress的命令行瑞士军刀，能让你脱离后台界面，用命令完成站点创建、插件管理、数据库操作等所有核心功能，搭配Valet使用，本地开发效率直接翻倍。
第一步：环境准备 – 安装Homebrew（基础依赖）
Homebrew是macOS的包管理器，后续安装PHP、MariaDB等依赖都需要它。如果已经安装过Homebrew，直接跳过这步，执行brew update更新到最新版本即可。
未安装Homebrew的话，打开终端（启动台→其他→终端），执行以下命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"执行过程中会提示输入电脑密码（终端输入密码时不会显示字符，直接输入后回车即可），等待几分钟，看到「Installation successful」就说明安装完成了。
验证安装：输入brew -v，如果显示版本号（比如Homebrew 4.2.24），则说明安装成功。
第二步：安装核心依赖 – PHP + MariaDB
Valet运行需要PHP环境，而WordPress需要数据库支持，这里我们选择MariaDB（MySQL的分支，性能更优且兼容MySQL）。
1. 安装最新版PHP
直接用Homebrew安装最新稳定版PHP，终端执行：
brew install php安装完成后，验证是否成功：输入php -v，会显示当前PHP版本（2025年最新稳定版为PHP 8.3+）。
小贴士：如果需要切换PHP版本（比如部分旧项目需要PHP 8.2），可以用brew install php@8.2安装指定版本，再用valet use php@8.2切换Valet使用的PHP版本。
2. 安装MariaDB并配置
执行以下命令安装MariaDB：
brew install mariadb安装完成后，启动MariaDB服务：
brew services start mariadb「brew services start」会设置MariaDB开机自启，如果不想自启，也可以用mysql.server start手动启动（重启电脑后需要重新执行）。
3. 配置MariaDB root用户（关键步骤）
默认情况下，MariaDB的root用户没有密码，且使用auth_socket认证，我们需要设置密码并切换到密码认证，方便后续WordPress连接。
终端执行以下命令，登录MariaDB root用户：
sudo mysql -u root输入电脑密码后，会进入MariaDB命令行（提示符变为mysql>），依次执行以下命令：
-- 切换到mysql系统数据库
USE mysql;
-- 查看当前用户认证方式
SELECT User, Host, plugin FROM mysql.user WHERE User = 'root';
-- 设置root用户密码（将'your_password'改为你自己的密码，比如'root'，方便记忆）
ALTER USER 'root'@'localhost' IDENTIFIED BY 'your_password';
-- 刷新权限，使配置生效
FLUSH PRIVILEGES;
-- 退出MariaDB命令行
EXIT;验证配置：重新执行mysql -u root -p，输入刚才设置的密码，能成功进入命令行就说明配置完成了。
第三步：安装Composer（Valet依赖）
Composer是PHP的依赖管理工具，Valet需要通过它安装。这里推荐用Homebrew安装，比手动下载更省心，终端执行：
brew install composer安装完成后，验证：输入composer -v，显示版本号则说明成功。
优化配置（可选）：默认Composer源在境外，下载速度较慢，建议设置阿里云镜像加速，终端执行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/第四步：安装并配置Laravel Valet
所有依赖都准备好后，开始安装Valet，全程终端操作，步骤非常简单。
1. 全局安装Valet
执行以下命令，通过Composer全局安装Valet：
composer global require laravel/valet安装完成后，需要将Composer的全局bin目录添加到系统环境变量，确保能直接使用valet命令。根据你使用的终端类型（默认是zsh），执行以下命令：
-- 编辑zsh配置文件
nano ~/.zshrc
-- 在文件末尾添加以下内容（直接复制粘贴）
export PATH="$HOME/.composer/vendor/bin:$PATH"
-- 保存并退出：按Ctrl+O，回车确认，再按Ctrl+X使配置生效：执行source ~/.zshrc。
2. 初始化Valet
执行以下命令安装Valet并配置相关服务（Nginx、DnsMasq）：
valet install执行完成后，Valet会自动启动相关服务，且设置为开机自启。验证是否安装成功：终端输入ping test.wpzhan.com，如果显示「64 bytes from 127.0.0.1」，说明DnsMasq配置成功，wpzhan.com域名已指向本地。按Ctrl+C停止ping测试。
3. 配置本地站点目录
我们需要创建一个目录来存放本地WordPress项目，这里以在用户目录下创建「www」目录为例：
-- 创建www目录
mkdir ~/www
-- 进入www目录
cd ~/www
-- 将该目录设置为Valet的站点根目录（park命令会让Valet监控这个目录下的所有项目）
valet park以后只要把WordPress项目放在「~/www」目录下，就能通过「项目名.wpzhan.com」访问（比如项目名为wordpress，访问地址就是wordpress.wpzhan.com）。
第五步：安装phpMyAdmin（可视化管理数据库）
虽然我们用终端操作数据库，但有时可视化管理更方便，这里教你快速配置phpMyAdmin并集成到Valet：
- 下载phpMyAdmin：打开phpMyAdmin官网，下载最新稳定版（选择「All languages」的压缩包）；
- 解压压缩包：将下载的压缩包解压，把解压后的文件夹重命名为「pma」（方便记忆）；
- 移动到站点目录：将「pma」文件夹拖到我们刚才创建的「~/www」目录下；
- 配置Valet访问：终端执行
cd ~/www/pma，然后执行valet link； - 验证访问：打开浏览器，输入「pma.wpzhan.com」，用MariaDB的root用户和刚才设置的密码登录，能正常进入管理界面就说明配置成功了。
第六步：安装WP-CLI（WordPress命令行工具）
用最新的官方脚本安装WP-CLI，步骤简单且稳定：
- 下载WP-CLI可执行文件：终端执行
- 验证文件可用性：执行
- 设置全局可用：将wp-cli.phar移动到系统可执行目录，并赋予执行权限
- 验证安装成功：执行
wp --info，如果直接显示WP-CLI信息，说明全局配置成功。
第七步：实战测试 – 用Valet + WP-CLI快速创建WordPress站点
到这里，环境已经全部配置完成，我们来实战测试一下，用命令行快速创建一个WordPress站点：
- 进入站点目录：
cd ~/www - 用WP-CLI下载WordPress核心文件（项目名设为「mywp」）：
- 创建数据库：打开浏览器访问pma.test，登录后创建一个名为「mywp_db」的数据库（左侧「新建」→输入数据库名→选择utf8mb4编码→创建）；
- 配置WordPress配置文件：终端执行
- 安装WordPress：执行
- 访问站点：打开浏览器输入「mywp.test」，就能看到WordPress站点首页了；输入「mywp.test/wp-admin」，用刚才设置的管理员账号密码登录后台，完美可用！
常用命令汇总（Valet + WP-CLI）
Valet常用命令
valet start # 启动Valet服务
valet stop # 停止Valet服务
valet restart # 重启Valet服务
valet use php@8.2 # 切换PHP版本
valet forget # 取消当前目录的Valet监控
valet links # 查看所有Valet链接的站点WP-CLI常用命令
wp plugin install akismet --activate # 安装并激活Akismet插件
wp theme install twentytwentythree --activate # 安装并激活默认主题
wp post create --post_type=post --post_title=测试文章 --post_content=这是一篇测试文章 --post_status=publish # 创建并发布文章
wp db export backup.sql # 导出数据库备份
wp core update # 更新WordPress核心版本
wp cli update # 更新WP-CLI到最新版本常见问题解答
1. 执行valet命令提示「command not found」？ 大概率是环境变量配置有误，重新执行source ~/.zshrc，如果还是不行，检查~/.zshrc文件中是否添加了Composer的bin目录路径，确保路径正确。
2. 访问pma.wpzhan.com提示403错误？ 进入pma目录，执行valet restart重启Valet，或者检查pma目录的权限，执行chmod -R 755 ~/www/pma赋予正确权限。
3. WP-CLI安装时提示权限不足？ 执行sudo mv命令时确保输入了正确的电脑密码，或者将/usr/local/bin目录的权限调整为当前用户所有：sudo chown -R $(whoami) /usr/local/bin。
以上就是2025年最新的macOS Valet + WP-CLI安装指南了。这套环境轻量、高效，非常适合终端爱好者进行WordPress本地开发。如果在安装过程中遇到其他问题，欢迎在评论区留言，我们一起交流解决～