laragon 搭建 laravel 10 需四步对齐：确认 php ≥ 8.1 并启用 mbstring、openssl、pdo、tokenizer、xml、ctype、json、intl 扩展；换阿里云镜像并执行 composer create-project laravel/laravel:^10.0 myapp；配置 .env 后运行 php artisan key:generate、config:clear、cache:clear；用 heidisql 建库 myapp，再执行 migrate 并启动服务访问 http://myapp.test。

用 Laragon 搭 Laravel 10 不难，关键在四步对齐：环境版本、依赖拉取、配置生效、服务启动。Laravel 10 要求 PHP ≥ 8.1，且必须启用特定扩展；直接跑默认命令容易卡住或报错，不是命令错了，是底层没配好。

确认 Laragon 的 PHP 版本和必需扩展

Laragon 自带 PHP，但默认可能不是 8.1+，也未必开了所有扩展。不能只看“PHP 已安装”，得验证运行时真实状态：

• 启动 Laragon → 托盘右键 → PHP → Version，确认显示 ≥ 8.1（推荐 8.2 或 8.3）
• 右键托盘 → PHP → PHP Extensions，勾选以下全部：mbstring、openssl、pdo、tokenizer、xml、ctype、json、intl
• intl 扩展在 Windows 上常被忽略，若勾选后仍报错，可手动进 C:\laragon\bin\php\php-{version}\php.ini，取消注释这行：extension=intl

换国内镜像 + 指定 Laravel 10 LTS 安装

默认拉取最新版（如 Laravel 11 beta），会因依赖冲突失败。必须锁定当前长期支持版（Laravel 10），并提速安装：

Laravel

避免常见的Laravel错误：N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载

• 打开 Laragon 终端（右键托盘 → Terminal → www），执行：
  composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 进入 C:\laragon\www，运行：
  composer create-project laravel/laravel:^10.0 myapp
• 若仍卡在 “Installing dependencies” 或提示 zlib 错误，加内存限制重试：
  COMPOSER_MEMORY_LIMIT=-1 composer create-project laravel/laravel:^10.0 myapp

配置 .env 并清缓存

.env 文件改完不生效？90% 是缓存没清。Laravel 启动后只读一次 .env，其余全靠 config 缓存驱动：

• 进项目目录：cd C:\laragon\www\myapp
• 复制并编辑：copy .env.example .env，确保这几项准确：
  APP_ENV=local
APP_DEBUG=true
APP_URL=http://myapp.test（别写 localhost 或 127.0.0.1，Laragon 虚拟主机认域名）
  DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=myapp（稍后建库时用这个名字）
  DB_USERNAME=root
DB_PASSWORD=
• 生成密钥：php artisan key:generate
• 立刻清缓存：php artisan config:clear && php artisan cache:clear

建库 + 迁移 + 启动

Laragon 自带 MySQL 和 HeidiSQL，不用额外装数据库工具：

• 启动 Laragon → 托盘 → MySQL → HeidiSQL → 登录（root / 空密码）→ 新建数据库，名设为 myapp，排序规则选 utf8mb4_unicode_ci
• 回到终端，执行迁移：php artisan migrate（如有 seeders 可追加 php artisan db:seed）
• 回到 Laragon 主界面 → 点击 Start All → 等 Apache 和 MySQL 都亮绿灯
• 浏览器访问 http://myapp.test —— 看到 Laravel 欢迎页即成功