composer create-project 本质是克隆并安装已存在的项目模板包，非创建空项目；常见报错因目标包未设"type":"project"、autoload缺失或误用普通库包导致。
composer create-project 不是“创建空项目”的命令，它本质是克隆一个已存在的、可安装的包（通常是框架或模板），并执行其 install 流程。直接运行 composer create-project vendor/name 很可能失败，除非该包明确声明了 type: project 并配置了正确的 autoload 和 scripts。
为什么 composer create-project 经常报错或生成异常目录？
常见错误包括：Could not find package vendor/name、生成的项目里没有 vendor/、index.php 缺失、甚至整个目录结构和预期不符。根本原因是：该命令不校验目标包是否真正适合作为“项目模板”——它只检查 composer.json 是否存在，并尝试 install 依赖，但不保证入口文件、引导逻辑或目录约定就绪。
典型踩坑场景：
- 误用普通库包（如
monolog/monolog）当作项目模板，结果只拉下源码没装依赖，也没有autoload.php入口 - 目标包未设置
"type": "project"，导致 Composer 不启用项目级安装逻辑（例如跳过require-dev的处理） - 包的
composer.json中autoload配置缺失或路径错误，导致vendor/autoload.php无法加载主应用类
如何正确指定目标包与安装路径？
基本语法是：composer create-project <package><directory><version> --stability=<stability></stability></version></directory></package>。其中 <package></package> 必须是 Packagist 上注册的完整命名（如 laravel/laravel），不能是本地路径或 Git URL（除非加 --repository-url）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 始终显式指定目录名，避免当前目录被覆盖：
composer create-project laravel/laravel my-app - 需要稳定版时加
--stability=stable，否则可能拉到dev-main分支（尤其 Laravel 11+ 默认行为） - 跳过交互式脚本（如 Laravel 的环境初始化）用
--no-interaction，适合 CI 环境 - 若要保留 Git 历史（方便后续提交），加
--keep-vcs；但默认不保留，因为 Composer 会清空原始包的.git
替代方案：什么时候不该用 create-project？
当你只需要一个空的 Composer 环境（比如写 CLI 工具、SDK 或纯库），直接 composer init 更干净。而想基于某个框架快速启动但又不确定模板是否可靠，优先查官方文档推荐的安装方式——Laravel 推荐 laravel new，Symfony 推荐 symfony new，它们封装了 create-project 并做了额外校验和补全（如生成 .env、设置权限、预编译配置）。
如果非要手动干预安装流程：
- 先
git clone模板仓库，再composer install，能完全掌控源码和分支 - 用
composer create-project --repository-url=指向私有 Packagist 或 JSON repo，适用于内部模板 - 对已生成项目想重装依赖（比如换 PHP 版本后），不要重复跑
create-project，改用composer install --no-dev或composer update
最易被忽略的一点：create-project 执行完不会自动帮你 chmod 存储路径（如 storage/）或生成 .env 文件——这些必须由目标包自己的 post-create-project-cmd 脚本完成。如果脚本缺失或失败，后续运行直接报错，得人工补全。
