本质是环境链路中断：PHP扩展未启用（如fileinfo缺失致vendor不生成）、Composer版本＜3.0、国内源不可达或权限问题；需检查php -m确认扩展、php --ini定位配置文件并启用extension、升级Composer≥3.0、配阿里云镜像、执行cp .env.example .env、php artisan key:generate及chmod -R 775 storage bootstrap/cache。
在命令行输入 laravel new myapp 或 composer create-project laravel/laravel myapp 后卡住、报错、生成空目录或缺少 vendor 文件夹，本质是环境链路中断——PHP 扩展未启用、Composer 未就绪、网络源不可达或权限被拦截，任一环节断裂都会导致项目骨架无法落地。
检查并启用必需的 PHP 扩展
运行 php -m | grep -E "(mbstring|openssl|fileinfo|tokenizer|ctype|json|xml|zip|curl|bcmath|pdo)"，缺任何一项都会让 Composer 在解压或校验阶段直接退出。尤其 【fileinfo 扩展缺失会导致 league/flysystem 安装失败，vendor 目录根本不会生成】。
定位 CLI 模式使用的 php.ini：php --ini，找到 “Loaded Configuration File” 对应路径。
用文本编辑器打开该 php.ini，搜索 extension=fileinfo 和 extension=mbstring，删除行首分号（如把 ;extension=fileinfo 改为 extension=fileinfo）。
保存后，在新终端中执行 php -m | grep fileinfo，有输出即生效；若无，说明改错了配置文件或未重启终端。
确保 Composer 版本 ≥3.0 并配置国内镜像
Laravel 13.2 要求 Composer ≥3.x，2.x 已不兼容。运行 composer --version，若显示 2.x，必须升级：composer self-update。
国内默认源极大概率超时。执行：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
验证镜像是否生效：运行 composer config -g repo.packagist，输出应为 https://mirrors.aliyun.com/composer/。
若仍卡在 “Resolving dependencies”，加内存限制重试：COMPOSER_MEMORY_LIMIT=-1 composer create-project laravel/laravel myapp --prefer-dist。
修复权限与初始化关键三步
第一步：进入项目根目录，确认 .env 存在。不存在则立即复制：cp .env.example .env。
第二步：生成应用密钥：php artisan key:generate。这一步不可跳过，【缺少 APP_KEY 将导致 Session 失效、CSRF 验证失败、所有加密功能瘫痪】。
第三步：开放 storage 和 bootstrap/cache 写权限：chmod -R 775 storage bootstrap/cache。Mac/Linux 用户若提示 permission denied，先执行 sudo chown -R $USER:$USER ./storage ./bootstrap/cache。
