Laravel 10 macOS环境配置关键在于构建稳定可复用的开发链路：先装Xcode命令行工具、Homebrew、PHP 8.2+和Composer，再选Valet（命令行轻量）或Herd（图形化开箱即用），最后用composer create-project创建项目，配好.env与APP_URL，启动MySQL并运行迁移。
在 macOS 上配置 Laravel 10 环境，关键不是堆砌工具，而是建立一条稳定、可复用、易维护的本地开发链路。Laravel 10 要求 PHP ≥ 8.1，且依赖 Composer 和一个 Web 服务方案（推荐 Valet 或 Herd），不建议用 PHP 内置服务器长期开发。
安装基础工具链
先确保系统就绪：
- 运行
xcode-select --install安装命令行开发工具 - 用官方脚本安装 Homebrew：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 执行
brew update并验证 brew 是否可用
安装 PHP 8.1+ 和 Composer
Laravel 10 明确要求 PHP 8.1 或更高版本（推荐 8.2 或 8.3）：
- 执行
brew install php@8.2（安装后会提示添加路径，按提示操作或手动将/opt/homebrew/bin加入$PATH） - 验证：运行
php -v应显示 8.2.x；which php应指向 Homebrew 路径 - 安装 Composer：
brew install composer，再运行composer --version确认
选用轻量本地环境：Valet 或 Herd
两者都是 Laravel 官方支持的 macOS 专用方案，零配置、自动 HTTPS、低资源占用：
-
Valet：终端驱动，适合习惯命令行的开发者
安装：composer global require laravel/valet→valet install
启用后，所有项目目录下执行valet park即可用project-name.test访问 -
Herd：图形界面 + 自动管理，适合希望“开箱即用”的用户
官网下载安装包（herd.dev），启动后自动托管~/Sites下的项目，域名格式为project-name.herd
创建并初始化 Laravel 10 项目
两种等效方式，推荐用 Composer 直接拉取：
- 执行：
composer create-project laravel/laravel myapp --stability=stable --prefer-dist
注意：Laravel 10 已不再支持--prefer-dist的旧写法，但该命令仍兼容；更稳妥可省略参数：composer create-project laravel/laravel myapp - 进入项目：
cd myapp - 复制环境文件：
cp .env.example .env - 生成密钥：
php artisan key:generate - 如需数据库，用
brew install mysql启动服务，并在.env中填好DB_DATABASE、DB_USERNAME等
验证与常见注意事项
项目建好后别急着跑，先检查几处关键点：
- 确认
.env中APP_URL=http://myapp.test（Valet）或http://myapp.herd（Herd），和你实际使用的域名一致 - 运行迁移前确保数据库服务已启动：
brew services start mysql - 首次访问前执行：
php artisan migrate（如有迁移文件） - 切勿将
.env提交到 Git —— 默认.gitignore已包含它，但仍建议执行git check-ignore -v .env确认 - Laravel 10 默认禁用
APP_DEBUG在生产环境，本地开发可保持APP_DEBUG=true，但上线前务必改为false
