composer create-project是唯一能直接生成可运行项目骨架的命令，它从"type": "project"模板包拉取完整结构、自动安装依赖并执行初始化脚本；而composer init仅生成空composer.json，composer install要求已有composer.lock，composer require只将框架装入vendor/导致缺失入口和配置。
composer create-project 是唯一能直接生成可运行项目骨架的命令，其他方式（比如 composer init 或 composer require）都做不到——它们不拉文件、不建目录、不执行初始化脚本。
为什么不能用 composer init 或 composer install 启动新项目
你不是在写一个库，而是在启动一个应用。框架官方文档写的“安装 Laravel”，指的就是 create-project，不是 init。
-
composer init只输出 10 行 JSON，之后还得手动加 autoload、require、git init、配 web server root——90% 的人卡在第二步 -
composer install要求本地已有composer.lock，新项目根本没这个文件，强行运行只会报错：No composer.lock file present. You must run 'composer install' to generate one.，这是个死循环提示 -
composer require laravel/laravel的结果是把源码塞进vendor/laravel/laravel/，artisan和routes/都不在项目根目录，php artisan serve直接报错
create-project 必须传的三个参数怎么填才不翻车
最简形式是 composer create-project vendor/name target-dir，但漏掉任一关键点都会失败：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
target-dir必须是**不存在的空目录**，否则报错Project directory is not empty；不能用.（当前目录），除非你确认它是空的 - 包名要精确匹配 Packagist 注册名，比如 Laravel 是
laravel/laravel，ThinkPHP6 是topthink/think，不是thinkphp/think - 版本号要用双引号包裹，尤其是含
^或*时，例如"^11.0"或"11.*"；只写11可能被 shell 展开或解析失败 - 默认只拉 stable 版本（如
v11.2.0），不是main分支；要 dev 版得加--stability=dev
国内镜像滞后导致 Could not find package 怎么办
错误信息不代表包名错了，大概率是镜像源不同步或稳定性设置问题：
- 临时切回官方源：
composer config -g repo.packagist composer https://packagist.org - 私有模板必须提前在
composer.json里声明repositories，且type必须是vcs，URL 指向 HTTPS 或 SSH 地址 - 目标包的
composer.json中必须有"type": "project"，否则会被当成普通库装进vendor/，而不是展开成项目根目录 - 运行
composer clear-cache清掉本地缓存，再试
执行完没生成 vendor/autoload.php 或 .env 怎么办
这不是命令失败，而是 composer install 步骤没跑完，常见于 CI 环境、Docker 构建或网络中断后自动退出：
- 先进入项目目录：
cd myapp - 手动补装依赖：
composer install - 检查是否生成了
.env：如果没有，复制.env.example并运行php artisan key:generate - 如果用了 Breeze/Jetstream，记得立刻执行
php artisan migrate，否则登录页会 500 - 前端部分别忘了
npm install && npm run build（不是dev），首次初始化必须构建产出
composer.json 顶层生效，不是在模板包自己的 composer.json 里定义——很多人把脚本写错位置，结果密钥没生成、.env 没复制，却以为是命令问题。
