本地运行 Laravel 项目只需三步：装环境（Windows 用 Laragon，Mac/Linux 配 PHP+Composer）、配项目（复制代码并正确设置 .env）、启服务（composer install、key:generate、migrate 后 php artisan serve 或 Laragon 访问）。
直接在本地跑起一个 Laravel 项目，核心就三件事：装好运行环境、配对项目配置、拉起服务。不需要服务器，也不用 Docker（除非你明确要它），Windows 用户用 Laragon 最省心，Mac/Linux 用户用 PHP + Composer + 内置服务器也完全够用。
装环境：推荐 Laragon（Windows）或手动配 PHP+Composer（全平台）
✅ Windows 用户——用 Laragon（2026 年仍是最稳的本地方案）：
• 下载安装最新版（官网 laragon.org），启动后托盘显示绿色「Running」；
• 它已自带 Apache、PHP 8.2+、MySQL、phpMyAdmin，无需单独装扩展；
• 确保 PHP 的 mbstring、openssl、pdo_mysql、tokenizer、xml、ctype、json 已启用（Laragon 默认全开，可进菜单 → PHP → php.ini 快速确认）。
✅ Mac/Linux 用户——自己配更灵活：
• PHP ≥ 8.1（Homebrew 用户：brew install php@8.2；Ubuntu：apt install php8.2-cli php8.2-mbstring php8.2-pdo php8.2-mysqlnd …）；
• Composer 必装，国内建议设镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/；
• 不用装 Apache/Nginx——Laravel 自带 php artisan serve 就能跑。
放项目：复制完整代码，重点检查 .env
• 把你的 Laravel 项目文件夹（含 app/、database/、composer.json、.env 等）放进 C:\laragon\www\（Windows）或任意目录（Mac/Linux）；
• 若只有 .env.example，复制重命名为 .env；
• 打开 .env，必须核对这三项：
→ APP_KEY：留空或写错都会报错，后续用 php artisan key:generate 补；
→ DB_DATABASE：填你要用的库名（如 myapp），不是用户名；
→ APP_URL：开发时写 http://localhost:8000 或 http://your-project.test（Laragon 自动支持）。
跑起来：装依赖、建库、执行迁移
• 进入项目根目录，终端执行：
composer install（装 PHP 包）；
php artisan key:generate（生成密钥，若 .env 里没有 APP_KEY）；
php artisan migrate（建表；如有初始数据，再加 php artisan db:seed）。
• 数据库准备（二选一）：
→ 用 Laragon：点托盘 → MySQL → HeidiSQL → 新建库（字符集选 utf8mb4_unicode_ci）；
→ 无备份但有迁移文件：上面 migrate 命令自动建；
→ 有 SQL 备份：在 HeidiSQL 或 phpMyAdmin 中导入即可。
启动并验证：别跳过最后一步
• Laragon 用户：点主界面「Start All」→ 浏览器打开 http://your-project.test；
• 其他用户：终端运行 php artisan serve → 访问 http://localhost:8000；
• 看到欢迎页或首页，说明成功；如果报错：
→ 先看浏览器错误信息（如 500 通常是 .env 配错或 APP_KEY 缺失）；
→ 再查日志：storage/logs/laravel.log；
→ 最后确认数据库是否连得上（php artisan tinker 后输 DB::connection()->getPdo(); 测试）。
