laravel项目创建失败主因是php扩展缺失、composer配置不当或环境变量未初始化；需检查cli模式php.ini中fileinfo/mbstring等扩展是否启用，确保composer≥2.5并配置国内镜像源，执行cp .env.example .env后运行php artisan key:generate。
Laravel项目创建失败，多数不是框架本身的问题，而是本地开发环境或网络配置没到位。核心环节卡在 composer create-project 这一步，只要理清依赖链和执行上下文，基本都能快速定位解决。
PHP扩展缺失（最常见）
Composer 在安装 Laravel 依赖时会校验多个 PHP 扩展，缺一不可。报错通常类似：
The following PHP extensions are required but are not installed: ctype, fileinfo, filter, hash, mbstring, openssl, session, tokenizer
关键点在于：fileinfo 和 mbstring 很容易被忽略，但它们是 Laravel 5.5+ 及后续版本的硬性要求。
- 运行
php --ini查出 CLI 模式下实际加载的php.ini路径 - 用文本编辑器打开该文件，搜索
extension=fileinfo和extension=mbstring - 若前面有分号
;，删掉；保存后重启终端 - 再运行
php -m | grep -E "(fileinfo|mbstring)"确认已启用
Composer 配置或版本问题
laravel new 命令本质是调用 Composer，所以 Composer 本身是否就绪，直接决定成败。
- 检查版本：
composer --version，确保 ≥ 2.5（旧版对 Laravel 10+ 支持不完整） - 国内用户必须设镜像源，否则大概率超时或失败：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 若仍卡住，可手动创建：
composer create-project laravel/laravel myproject --prefer-dist
权限与路径问题
尤其在 Linux/macOS 上，如果 ~/.composer 或目标项目目录权限受限，会导致写入失败。
- 修复全局 Composer 权限：
sudo chown -R $USER:$USER ~/.composersudo chmod -R 755 ~/.composer - 确保项目父目录可写，例如：
mkdir ~/Sites && cd ~/Sites，再运行创建命令 - Windows 用户请以“管理员身份运行”命令提示符或 PowerShell
环境变量与加密密钥缺失
项目目录生成成功但 php artisan serve 启动报错？很可能是 .env 文件没初始化。
- 进入项目目录后，先复制环境模板：
cp .env.example .env（Linux/macOS）或copy .env.example .env（Windows） - 生成应用密钥：
php artisan key:generate - 检查 .env 中
APP_KEY是否已写入 base64 开头的值
