执行composer create-project未生成Laravel9项目目录的求助

排查步骤与解决方案 #

• 检查Composer的路径配置
  执行composer config --list，查看vendor-dir和cache-dir的配置值，确认项目是否被安装到了非预期的路径（比如全局缓存目录）。可以尝试用绝对路径指定安装目录，命令示例：

  composer create-project laravel/laravel:^9.* /你的绝对路径/AppNameHere
  

• 排查权限问题

  • Linux/macOS环境：执行ls -ld .查看当前目录权限，确保当前用户拥有读写权限，必要时调整目录权限或用sudo执行命令（不推荐长期使用sudo，建议优先调整目录权限）。
  • Windows环境：右键终端/命令提示符选择“以管理员身份运行”，再执行创建命令，避免权限不足导致目录无法生成。

• 查看Composer详细执行日志
  执行命令时添加-vvv参数开启日志追踪，命令示例：

  composer create-project laravel/laravel:^9.* AppNameHere -vvv
  

  从日志中可以看到每一步的执行细节，包括下载、解压、目录生成的具体路径，定位是否存在隐藏的错误或路径异常。

• 清理Composer缓存
  缓存的安装包可能存在异常，执行以下命令清理后重新尝试：

  composer clear-cache
  

• 验证PHP环境依赖
  Laravel9要求PHP版本≥8.0.2，且需安装BCMath、Ctype、JSON、Mbstring等扩展。执行php -v确认版本，php -m查看已安装扩展，确保环境满足要求——部分情况下依赖不达标但Composer未正确提示，会导致安装流程异常终止却显示“成功”。

• 手动替代create-project命令
  直接下载Laravel9分支的压缩包，解压到指定目录后，执行composer install安装依赖，以此排查是否是create-project命令本身的问题。

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