Composer包管理器怎么基于现有模板快速创建新项目-composer-PHP中文网

composer create-project才是真·模板初始化，它下载完整项目骨架（含public/、.env.example、artisan等），执行composer install和post-create-project-cmd脚本（如自动生成app_key）；而laravel new被官方弃用，composer init仅生成空配置。

composer包管理器怎么基于现有模板快速创建新项目

直接用 composer create-project，别用 laravel new 或 composer init ——前者是官方弃用的黑盒封装，后者只生成空配置，都不算“基于模板创建项目”。

为什么 `create-project` 才是真·模板初始化

它不是安装依赖，而是下载整个项目骨架（含 public/、.env.example、artisan 等），再执行 composer install 和 post-create-project-cmd 脚本（比如自动生成 APP_KEY）。composer init 只给你一个空 composer.json，连目录结构都要手建。

真正生效的是包的 "type": "project" 字段——查一个包是否可用：composer show laravel/laravel | grep type，输出含 project 才行
常见能用的模板： laravel/laravel（不是 laravel/framework）、symfony/skeleton、roots/bedrock
拉到的不是源码片段，而是完整可运行的项目快照，vendor 里装的是该模板声明的全部依赖，不是你当前环境的全局依赖

`create-project` 命令必须带全三个参数

漏掉任一参数都可能出错或行为异常：

<package></package>：必须是完整包名，如 laravel/laravel；也支持 Git URL（git@github.com:myorg/starter.git）或本地路径（../templates/my-starter）
<directory></directory>：目标文件夹不能已存在（哪怕为空），否则报错退出；想覆盖？先 rm -rf myapp
<version></version>：必须加引号，如 "11.*" 或 "dev-main"；不加引号时 shell 会把 * 当前目录通配符展开，导致版本解析失败

不加这些选项，CI/CD 和 Docker 里大概率卡住

默认交互式行为在无终端环境（如 GitHub Actions、Docker build）中会永久挂起：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

--no-interaction（简写 -n）：跳过 Git 凭据、是否初始化 Git 仓库等所有提问
--prefer-dist：强制走压缩包安装，比 --prefer-source（Git clone）快且稳定，国内网络尤其关键
--remove-vcs：删掉模板自带的 .git，避免新项目继承错误提交历史
--no-scripts：调试模板时临时禁用 post-create-project-cmd（比如 .env 生成逻辑有 bug），确认结构后再去掉

典型稳态命令：composer create-project laravel/laravel myapp "11.*" --no-interaction --prefer-dist --remove-vcs

装完立刻验证三件事，别等 `php artisan` 报错才回头

静默失败很常见，vendor 目录看似存在，但 autoload 可能没生成成功：

检查 vendor/autoload.php 是否存在且可读——WSL 或 Docker volume 挂载时，symlink 可能被跳过，导致文件缺失
运行 php artisan tinker：能进入交互式控制台，说明 autoloader 和基础命令链正常
确认 .env 有内容且 APP_KEY 已生成——加了 --no-scripts 就不会自动执行 key:generate，得手动补

最易忽略的是权限和镜像源问题：如果 vendor/ 为空或不全，先 composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/ 换国内源，再重试；Windows 下避免用 Git Bash，换 PowerShell 或 CMD。