应使用 composer create-project laravel/laravel myapp 安装 laravel，它自动拉取完整骨架、安装依赖、复制 .env.example、生成 app_key；手动 init+require 会遗漏 autoload 配置、脚本钩子和环境初始化逻辑，导致 artisan 命令失效或 500 错误。
直接用 composer create-project laravel/laravel myapp 就行，别绕路——它自动拉骨架、装依赖、生成 .env、跑 key:generate；所有其他方式（composer init + require、git clone、laravel/installer）都容易漏关键步骤，导致 artisan 找不到命令、Class not found 或 500 错误。
为什么不能先 composer init 再 require laravel/framework
Laravel 不是单个库，而是一整套带钩子脚本、autoload 规则、环境初始化逻辑的项目骨架。create-project 会完整执行：composer install、@php artisan package:discover、php artisan key:generate；手动方式只扔进 laravel/framework，漏掉：
-
autoload配置里的psr-4映射（App\、Database\等）和classmap（如bootstrap/app.php） -
scripts中的 post-root-package-install 和 post-create-project-cmd 钩子 -
.env.example复制与APP_KEY自动生成 -
providers数组依赖package:discover自动注册，没这步就等于“引擎装好了但没点火”
create-project 指定版本时怎么写才不报错
版本约束必须符合语义化格式，且 shell 层要防通配符展开。常见错误是把 11 当成版本号直接写，结果 Composer 去搜包名含 11 的仓库。
- ✅ 正确写法：
composer create-project laravel/laravel myapp "11.*"（引号包裹，防*展开） - ✅ 或：
composer create-project laravel/laravel:^11.0 myapp（^必须紧贴包名，不能空格） - ❌ 错误写法：
composer create-project laravel/laravel myapp 11（被当包名）、"v11.*"（Composer 不认v前缀）、"11.x"（非标准约束） - 验证是否生效：进项目后看
composer.json里"laravel/framework"的version字段是否为"^11.0"或类似值
安装卡住或报 zlib/SSL/Class not found 怎么快速定位
这不是 Laravel 本身的问题，90% 是环境或网络干扰。优先查三件事：
- PHP 版本是否匹配：Laravel 11 要求
php >= 8.2，运行php -v确认；缺扩展（mbstring、tokenizer、openssl）会导致静默失败或后续artisan报看似无关的语法错误，用php -m | grep -E 'mbstring|tokenizer|openssl'检查 - 镜像源是否滞后：新 Laravel 版本发布初期，国内镜像可能未同步，报
Could not find package laravel/laravel时临时切回官方源：composer config -g repo.packagist composer https://packagist.org - 权限或缓存损坏：Docker volume uid/gid 不匹配会导致
vendor/创建失败、进程假死在Installing dependencies；zlib_decode(): data error多因网络中断导致压缩包损坏，删掉~/.composer/cache/重试
最易被忽略的是：create-project 成功后，vendor/autoload.php 不存在 ≠ 安装失败，而是依赖根本没装上——常见于 CI/CD 加了 --no-install，或重复执行时跳过覆盖。务必进目录执行 ls -l vendor/autoload.php 验证，不存在就补 composer install --no-interaction，别用 update 替代。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
