composer create-project 本质是下载并安装现成项目骨架，而非初始化空目录，它拉取指定包的最新稳定版代码，解压、安装依赖、生成配置文件，最终提供可直接运行的项目目录。
composer create-project 本质是下载并安装一个现成的项目骨架
它不是从零初始化空目录，而是拉取某个包（比如 laravel/laravel）的最新稳定版代码，解压、安装依赖、生成配置文件，最终给你一个可直接运行的项目目录。如果你想要空白项目，该用 composer init。
最常用写法：指定包名 + 目录名 + 版本约束
命令格式固定：composer create-project vendor/name target-dir version。三个参数里只有前两个必须，版本可省略（默认 latest stable），但漏掉容易踩坑——比如 Laravel 11 已发布，不加 ^10 可能直接装上不兼容的版本。
-
composer create-project laravel/laravel myapp→ 装最新稳定版 Laravel -
composer create-project symfony/skeleton myapp "6.4.*"→ 锁定 Symfony 6.4 分支 -
composer create-project drupal/recommended-project mysite --no-interaction→ 自动跳过交互式配置（适合 CI）
常见失败原因：权限、网络、包类型不匹配
报错 Could not find package vendor/name，大概率不是拼错了名字，而是这个包没有 type: project 字段，或未启用 packagist.org 镜像源。私有包还要提前配置 auth.json。
- 检查包是否真支持 project 模式：打开其
composer.json，确认含"type": "project" - 国内用户务必先执行
composer config -g repo.packagist composer https://packagist.phpcomposer.com（或阿里云镜像） - 若提示
Permission denied，别直接 sudo；改用chown -R $USER:$USER ~/.composer修复本地缓存权限
--stability 和 --prefer-dist 的实际影响
这两个选项控制“装什么”和“怎么装”，不是可有可无的开关。
-
--stability=dev允许安装dev-main或dev-develop分支，但会跳过稳定性检查，可能引入破坏性变更 -
--prefer-dist（默认）走压缩包下载，快且干净；--prefer-source则 clone git 仓库，方便后续改源码，但体积大、易因网络中断失败 - 想跳过 autoload 生成？加
--no-autoloader，但之后要手动跑composer dump-autoload
真正麻烦的是嵌套依赖里的 post-create-project-cmd 脚本——它们可能自动执行 php artisan key:generate 或 npm install，出错时错误堆栈藏得很深，得看最后几行输出找真实失败点。
