Composer怎么创建项目脚手架_Composer create-project命令【实战】

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 的设计粒度，以及你能否接受它的固定流程。一旦需求超出这个边界，就该考虑切换方案了。