Laravel new example-app命令无法创建项目，求助原因分析

核心原因分析 #

laravel new和composer create-project的底层逻辑存在差异：

• composer create-project直接从Packagist拉取完整的Laravel项目骨架包，流程更简洁直接。
• laravel new通过全局安装的Laravel安装器处理项目创建，包含额外步骤（比如拉取最新脚手架配置、初始化Git仓库等），任何一个环节异常都会导致进程挂起。

常见触发问题的场景：

1. 安装器与Laravel版本不兼容：旧版本安装器不支持最新Laravel的创建流程，反之亦然。
2. Composer全局缓存损坏：全局依赖的缓存文件出错，导致安装器无法正常调用后续依赖。
3. 网络/镜像源限制：安装器需要拉取的部分资源（比如官方脚手架）无法通过当前镜像源获取，导致进程停滞。
4. Windows权限/路径问题：全局Composer的bin目录未加入系统PATH，或终端权限不足、被杀毒软件拦截文件写入操作。

具体解决步骤 #

1. 更新Laravel安装器 #

先查看当前安装器版本：

laravel --version

若版本不是最新，执行强制更新命令：

composer global require laravel/installer --update-with-all-dependencies

更新完成后重试laravel new example-app。

2. 清理Composer全局缓存 #

缓存损坏是常见诱因，执行清理命令：

composer clear-cache

之后重新全局安装安装器，再测试项目创建。

3. 调整Composer镜像源 #

部分镜像源未同步Laravel安装器所需的额外资源，切换到稳定镜像：

# 查看当前全局镜像配置
composer config -g repo.packagist
# 切换到国内稳定镜像
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

配置完成后重试命令。

4. 检查Windows环境配置 #

• 打开系统环境变量，确认%USERPROFILE%\AppData\Roaming\Composer\vendor\bin已加入PATH，未添加则手动补充后重启终端。
• 用管理员权限打开CMD/PowerShell执行laravel new，避免权限不足导致文件写入失败。
• 暂时关闭杀毒软件或防火墙，排查是否存在操作拦截。

5. 查看详细日志定位问题 #

执行命令时添加-v参数输出详细日志，定位卡住的具体环节：

laravel new example-app -v

根据日志提示针对性解决（比如某资源拉取超时则单独处理网络问题）。

内容的提问来源于stack exchange，提问作者RamzNegar