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 并不总代表包名错了,更可能是: