create-project不能用require替代，因为require仅向现有项目添加依赖、不创建目录、不复制骨架文件、不执行项目级初始化脚本；而create-project是「克隆+安装+初始化」三合一操作，专为产出可直接运行的完整项目设计。
create-project 为什么不能用 require 替代
因为 composer require 只往现有项目里加包，不会创建目录、不复制骨架文件、不执行项目级初始化脚本；而 composer create-project 是「克隆 + 安装 + 初始化」三合一操作，目标是产出一个可直接运行的完整项目。
常见错误现象：用 composer init 生成空 composer.json，再 composer require laravel/framework——结果 laravel/framework 进了 vendor/，但没有 artisan、没有 routes/、没有 .env.example，根本不是 Laravel 项目。
-
create-project拉的是laravel/laravel（type: "project" 的模板包），不是laravel/framework（type: "library" 的核心库） - 模板包必须在
composer.json里声明"type": "project"，否则create-project会报Could not find package - 脚本钩子如
post-create-project-cmd只在新项目根目录的composer.json中生效，且名称必须全小写、带连字符
指定版本和路径时最容易踩的坑
不加引号、漏掉路径、误用点号，都会导致命令失败或行为异常。
比如 composer create-project laravel/laravel myapp 10.* 在 shell 中会被提前展开通配符，实际执行变成 composer create-project laravel/laravel myapp 10.abc 10.def...，报错或装错版本。
- 版本号必须用双引号包裹：
"10.*"或"^10.0" - 想安装到当前目录，末尾必须写
.：composer create-project laravel/laravel . "10.*" - 目标目录已存在且非空，命令默认卡住问是否删除；加
-n（即--no-interaction）才能强制覆盖 - 不指定目录时，Composer 默认用包名最后一段建文件夹（
laravel/laravel→laravel），容易和已有目录冲突
CI/CD 或批量部署时必须加的关键选项
默认交互式行为在自动化环境里会卡死，比如 Git 凭据输入、权限确认、脚本交互式提问。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真实 CI 流水线中，没加 --no-interaction 的 create-project 常静默挂起，日志里只显示 “Loading composer repositories”，实际卡在 SSH 密码提示上。
-
--no-interaction（简写-n）：跳过所有用户输入，包括 Git 凭据、目录覆盖确认、脚本里的readline() -
--prefer-dist：强制走压缩包而非 Git 克隆，避免内网无 SSH key 或 Git 协议被墙的问题 -
--remove-vcs：删掉模板自带的.git，防止新项目误提交旧历史 -
--no-scripts：调试模板时禁用post-create-project-cmd，避免脚本里硬编码路径或依赖未就绪的工具
私有模板或自定义骨架跑不通的三个检查点
报 Could not find package 不一定是包名错了，大概率是源配置或稳定性设置没对上。
私有 Git 仓库地址必须写全：git@github.com:myorg/my-skeleton.git，不能简写为 myorg/my-skeleton；否则 Composer 会去 Packagist 查，当然找不到。
- 确认模板包的
composer.json含"type": "project"，这是create-project识别它的唯一依据 - 若模板只有
dev-main分支，得显式加--stability=dev，否则默认只搜stable - 私有仓库需在全局或项目级
composer.json中声明repositories，且type必须为vcs，URL 必须可访问（HTTPS 或 SSH）
最隐蔽的坑是 PHP 版本不匹配：模板要求 php: ^8.2，本地是 8.1，报错信息藏在 [RuntimeException] 里，不是 Composer 问题，换 PHP 或换模板版本就行。
