composer create-project 本质是克隆并安装已存在的项目模板包，非通用脚手架工具；其“脚手架”效果依赖模板包预设的 post-create-project-cmd 钩子，不支持变量渲染或交互式生成。
composer create-project 不是创建“脚手架”的通用命令，它本质是克隆一个已存在的、可安装的包（通常是带 composer.json 的完整项目模板），并执行其依赖安装和自动初始化逻辑。能不能当脚手架用，取决于目标包是否设计为模板项目。
为什么 create-project 常被误当成“脚手架生成器”
因为很多框架（如 Laravel、Symfony、Laravel Zero）把官方项目模板发布为 Packagist 上的可安装包（如 laravel/laravel），create-project 正好能拉取这类包的最新稳定版，并自动运行 post-create-project-cmd 脚本（比如重命名 .env.example、生成密钥等）。这不是 Composer 自身的功能，而是模板包作者在 composer.json 里配置的钩子。
- 它不解析或渲染模板变量（如 {{name}}），也不支持交互式提问
- 它不会从空目录开始“生成结构”，而是复制远程仓库的某次提交（通常是
main或master分支的最新 tag） - 如果目标包没有定义
scripts.post-create-project-cmd，那就只是个静态文件拷贝 +composer install
正确使用 create-project 的三个关键参数
最简命令是 composer create-project vendor/name target-dir，但实际中必须注意：
-
target-dir必须不存在，否则报错Project directory ... is not empty - 加
--stability=dev才能拉取dev-main分支；默认只认stable，可能装到旧版 - 加
--remove-vcs会删掉.git目录——这对新项目很必要，否则你提交时会把模板的 Git 历史一起推上去
例如创建 Laravel 11 开发版：
composer create-project laravel/laravel myapp --stability=dev --remove-vcs
常见失败场景和对应解法
错误信息 Could not find package vendor/name 并不总代表包名错了，更可能是：
- 包未在 Packagist 公开注册（私有模板需先配置
repositories） - 包的
composer.json中"type"不是project（虽然非必需，但类型为project是社区约定） - 当前 Composer 版本太老，不支持包声明的 PHP 版本约束（如模板要求
^8.2，而你本地是 PHP 8.1）
私有模板示例（需提前在 composer.json 里写）：
{
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/myorg/my-template"
}
]
}
之后才能运行：composer create-project myorg/my-template myapp --remove-vcs
想真正定制脚手架？别只靠 create-project
它适合“拿来即用”的标准模板，但如果你要动态替换占位符、跳过某些步骤、或根据用户输入生成不同结构，就得组合其他工具：
- 用
composer create-project拉基础模板 - 再用
sed/jq/ PHP 脚本批量改名、删文件、注入值 - 或者直接用专用工具如
spiral/app-builder或自研 CLI，把create-project当作其中一环
真正的复杂点在于：模板的可维护性依赖于作者对 post-create-project-cmd 的设计粒度，以及你能否接受它的固定流程。一旦需求超出这个边界，就该考虑切换方案了。
