composer create-project是唯一能完整复制项目骨架并执行初始化脚本的命令，它自动下载含composer.json的稳定版模板、创建空目标目录、运行post-create-project-cmd（如生成.env和APP_KEY），而composer install仅还原已有lock文件的依赖，无法初始化新项目。
别再用 composer init + composer require + 手动写脚本这套组合拳了——真正省时间的初始化，是直接用 composer create-project 一条命令拉起带骨架、装好依赖、跑通自动加载的完整项目。
为什么 composer init 不该是你的第一步
composer init 只生成空 composer.json，不下载代码、不建目录结构、不执行安装脚本、不生成 vendor/autoload.php。它本质是个 JSON 表单填写器，不是项目启动器。
- 你填完后还得
composer require加框架，再composer install，最后手动复制index.php、.env.example等文件——这些本该由模板包自动完成 - 填错版本约束（比如写
"php": "8.1"没加^）会导致后续install失败，但错误要到执行时才暴露 - 团队里有人用
init，有人用create-project，项目根目录结构不一致，CI 脚本得写两套逻辑
composer create-project 的正确用法和参数避坑
这条命令才是真正“开箱即用”的起点：它从指定包仓库拉源码、解压、安装全部依赖、运行 post-root-package-install 等脚本（比如 Laravel 的 artisan key:generate），一步到位。
- 基础用法：
composer create-project laravel/laravel myapp—— 会拉取最新稳定版 Laravel 并初始化项目目录 - 指定版本：
composer create-project laravel/laravel myapp "10.*"，注意引号包裹，避免 shell 解析错误 - 跳过交互式安装（适合 CI）：
composer create-project --no-interaction laravel/laravel myapp - 强制重新安装（覆盖已有目录）：
composer create-project --remove-vcs --no-interaction laravel/laravel myapp，--remove-vcs会删掉 .git 目录，避免污染新项目 - 镜像源影响大：国内务必提前配好阿里云镜像，否则
create-project卡在下载阶段超时失败
何时才该用 composer init？只有一种情况
你正在从零开始写一个纯库（library），不依赖任何框架、不提供 Web 入口、不包含 public/ 或 routes/ 这类结构——比如开发一个独立的 SDK、工具类集合或 PSR-4 命名空间包。
- 这种场景下，
composer init是合理的：它帮你生成符合 Packagist 规范的composer.json，含autoload、type: "library"、minimum-stability等关键字段 - 但即便如此，也建议加
--name=yourvendor/yourpkg参数跳过交互，避免手误输错命名空间前缀 - 若后续想转成可执行项目（比如加 CLI 命令），别硬改，直接换
create-project拉个带 bin 的模板重来更干净
常见失败现象和快速定位方式
create-project 报错往往卡在三个环节：源不可达、PHP 版本不匹配、扩展缺失。别急着重试，先看输出最后一行。
- 报
Could not find package laravel/laravel：大概率镜像源没生效，执行composer config -g repo.packagist确认 URL 是否为https://mirrors.aliyun.com/composer/ - 报
Your requirements could not be resolved：检查 PHP 版本是否满足目标包要求（如 Laravel 10 需 PHP >=8.1），运行php -v和composer diagnose - 报
proc_open() has been disabled：宝塔或某些主机禁用了该函数，需在 PHP 配置中启用proc_open，不是 Composer 本身问题 - 成功但
vendor/autoload.php不存在：说明安装中途被中断，删掉项目目录重来，别试图composer install补救——骨架文件已丢失
最易被忽略的一点：create-project 下载的是包的「默认分支」（通常是 main 或 master），不是最新 tag。如果需要特定稳定版，必须显式指定版本约束，而不是依赖默认行为。
