composer create-project才是真正开箱即用的项目初始化方式，它拉取完整骨架、自动安装依赖、生成autoload并执行初始化脚本；而composer init仅生成空composer.json，需手动补全结构、依赖和配置，极易出错。
用 composer create-project 初始化项目，不是 composer init。后者只生成空 composer.json，不拉代码、不装依赖、不建目录结构，根本起不了项目。
为什么 composer init 不适合“初始化项目”
composer init 是个 JSON 表单填写器，不是项目启动器。它默认不创建 src/、tests/、index.php，也不执行任何安装脚本。填完后你面对的是一个空目录，还得手动 composer require 框架、composer install、再复制模板文件——这些本该由骨架包自动完成。
常见错误现象：
- 填了
name为myapp，但没设autoload，结果new App\Hello()报Class not found - 填了
php:8.1（缺^），composer install直接失败 - 目录名含空格或大写，
composer init卡在 “Package name” 死住
composer create-project 怎么用才不出错
这条命令才是真正开箱即用的起点：它从指定包仓库拉源码、解压、安装全部依赖、运行 post-create-project-cmd（比如 Laravel 的 artisan key:generate）。
必须控制的关键参数：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 myapp "11.*"（双引号防 shell 解析） - 跳过交互式确认，强制重装：
-n（等价于--no-interaction） - 删掉模板自带的
.git目录：--remove-vcs，避免首次git push带走上游历史 - 调试卡住时加
-vvv，能看到具体失败点（常见于 Git clone 失败或私有仓库未配auth.json）
注意：create-project 要求目标包的 composer.json 中必须有 "type": "project"，否则报 Could not find package，哪怕包地址完全正确。
什么时候才该用 composer init
只在两种场景下合理使用：
- 已有完整项目结构（如
src/、tests/已存在），只是想补上依赖管理和自动加载配置 - 要发布一个库（
"type": "library"），且明确知道命名空间、PSR-4 路径、PHP 版本约束等细节
实操底线：
- 必须显式填
--name="vendor/name"（全小写、字母开头、仅含字母数字和连字符） - PHP 版本约束必须写进
require字段：--require="php:^8.1"，不能只塞config.platform.php - 填完立刻跑
composer validate，它能提前发现license写成MIT License、authors缺邮箱、name格式非法等硬伤
真正容易被忽略的点是：即使 create-project 成功执行，进入项目目录后仍要确认 vendor/autoload.php 是否存在。如果缺失，说明 composer install 步骤中途退出了——此时得手动 composer install --no-dev 补上，否则所有 require_once 'vendor/autoload.php' 都会失败。
