laragon装laravel报错主因是环境衔接或初始化步骤错误，需用composer create-project命令在www目录下创建项目，配好.env并生成密钥，再通过add site快速托管访问。
用 Laragon 装 Laravel 报错，多数不是 Laragon 本身的问题，而是环境衔接或初始化步骤没走对。核心在于：Laragon 提供了 PHP、MySQL、Nginx/Apache 等运行环境，但 Laravel 项目仍需手动或半自动创建——它不自带“一键 Laravel 安装”按钮，得靠 Composer 命令触发。下面直接说清楚怎么绕过常见报错，用最稳的一键方式创建项目。
确认 Laragon 环境已就绪
启动 Laragon 后，先验证基础服务是否正常：
- 点右上角 ▶️ Start All，确保 PHP、MySQL、Web Server（如 Apache）状态为绿色
- 打开终端（Laragon 自带 Terminal 或 CMD/PowerShell），执行
php -v和composer -v，确认两者都可运行；若提示“不是内部命令”，说明 Composer 未加入系统 PATH，需重新安装并勾选“Add to PATH”选项 - Laragon 默认 PHP 版本通常为 8.0+，满足 Laravel 10/11 要求；如需切换，在 Laragon 主界面右键 PHP → Version → 选择兼容版本（如 8.2）
用 create-project 命令一键创建（推荐）
这是最干净、出错率最低的方式，不依赖 laravel/installer 全局工具，也避免权限和扩展缺失问题：
- 在 Laragon 的 www 目录下（如
C:\laragon\www）打开终端 - 运行命令（以项目名
myapp为例）：composer create-project laravel/laravel myapp --prefer-dist - 等待完成，进入目录：
cd myapp - 复制环境文件：
copy .env.example .env（Windows）或cp .env.example .env（如用 Git Bash） - 生成密钥：
php artisan key:generate
常见报错及对应解法
如果执行中卡住或报错，大概率是这几类：
-
“Could not find package laravel/laravel”：Composer 镜像源过期或不可达。临时切回官方源：
composer config -g repo.packagist composer https://packagist.org -
“PHP extension xxx is required”（如 mbstring、openssl）：Laragon 的 PHP 配置里这些扩展默认是开启的，但有时被注释。打开
C:\laragon\bin\php\php-{version}\php.ini，搜索并取消注释以下行：extension=mbstring、extension=openssl、extension=pdo_mysql，保存后重启 Laragon -
访问时显示 “Whoops, looks like something went wrong” 或白屏：多半是
.env没配好或缓存未清。检查.env中APP_KEY是否存在，然后运行：php artisan config:clear && php artisan cache:clear
在 Laragon 中快速托管并访问
项目建好后，不用改 vhost 或配置 Nginx：
- 回到 Laragon 主界面，点击 + Add Site
- 输入域名（如
myapp.test），根目录选到C:\laragon\www\myapp\public - 点 OK，Laragon 自动写入 hosts 并配置虚拟主机
- 浏览器打开
http://myapp.test，即可看到 Laravel 欢迎页
