composer create-project 命令用于基于现有模板创建新项目，如 laravel/laravel，并自动安装依赖；它会下载指定包的完整代码、复制到目标目录、执行 composer install 并触发初始化脚本，适合快速搭建框架应用。
当你运行 composer create-project 命令时，Composer 会从一个已有的项目模板（通常是框架或应用骨架）创建一个新的本地项目。它不是安装依赖，而是直接复制整个项目的结构，包括其 composer.json 配置，并自动安装所需的依赖包。
命令的基本语法
执行该命令的格式如下：composer create-project vendor/package-name [target-directory] [version]
-
vendor/package-name：你要创建项目的包名，比如
laravel/laravel - target-directory（可选）：指定新项目存放的目录名，如果不填，默认使用包名
-
version（可选）：指定要使用的版本，如
dev-main、1.0.0等
内部工作流程
这个命令实际做了几件事：
GitHub操作助手
下载
用大白话操作当前项目的 Git/GitHub——配置 GitHub（装 gh CLI + 登录 + 建仓库）、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发（例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git
- 从 Packagist 中查找指定的包
- 下载该包的完整代码（相当于克隆整个仓库）
- 将项目文件复制到你指定的目标目录
- 读取该项目自带的
composer.json文件 - 自动执行 composer install 安装所有依赖项
- 如果项目定义了脚本（scripts），还可能触发一些初始化操作，比如生成密钥、清理.git信息等
常见使用场景
这个命令特别适合用来快速搭建基于框架的新应用：
- 创建 Laravel 应用：
composer create-project laravel/laravel my-site - 使用特定 PHP 版本分支：
composer create-project symfony/skeleton my-app "6.4.*" - 基于开发分支测试：
composer create-project yiisoft/yii2-app-basic my-yii-app dev-master
基本上就这些。它本质上是一个“项目生成器”，比单纯 require 包更完整，适合从零开始搭建应用。
