composer init 是交互式生成 composer.json 的向导，非空项目初始化快捷命令；必须明确项目结构意图才能正确使用，否则易导致自动加载失效或依赖冲突。
composer init 不是用来“初始化空项目”的快捷命令，它本质是交互式生成 composer.json 的向导，**必须有明确的项目结构意图才能用对**。直接在空目录下跑 composer init，很容易生成一个没用的、甚至引发后续依赖冲突的配置。
为什么 composer init 容易踩坑
它默认把当前目录当项目根，但不校验是否存在 src/、tests/ 等约定目录；也不检查 PHP 版本兼容性声明是否合理；更不会帮你设 PSR-4 自动加载——这些全靠手动输，一不留神就填错。
常见错误现象：
- 填了
name为myapp，但没设autoload，结果vendor/autoload.php加载不了自己写的类 - 填了
require依赖却漏掉php版本约束，导致 CI 构建失败 - 选了
PSR-4映射但路径写成src/，实际代码在lib/下，自动加载失效
composer init --no-interaction 的真实用途
这个参数不是“跳过思考”，而是跳过交互式提问，用内置默认值快速生成骨架。但它只适合已有明确规范的团队场景，比如统一要求：
- 命名空间固定为
App\ - 源码目录固定为
src/ - PHP 版本锁死为
^8.1
此时可配合 --require 和 --autoload 一次性写入：
composer init --name="myorg/myproject" --description="My CLI tool" --type="library" --require="php:^8.1" --autoload="psr-4:App\:src/" --no-interaction
注意：--autoload 参数值格式必须是 psr-4:Namespace:path/，中间用冒号分隔，末尾斜杠不能少。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
更稳妥的初始化方式：手写 composer.json 起步
对新手或小项目，直接创建最小可用的 composer.json 比跑 init 更可控：
- 先建好
src/目录，放一个Example.php，命名空间写App\ - 在项目根新建
composer.json，内容如下：
{
"name": "myorg/myproject",
"type": "project",
"autoload": {
"psr-4": {
"App\": "src/"
}
},
"require": {
"php": "^8.1"
}
}
然后执行 composer install ——它会生成 vendor/ 和 composer.lock，且自动加载立刻生效。不需要先 update，也不依赖交互式问答。
初始化后第一件该做的事：验证 autoload 是否真通
很多人以为 composer install 成功就完事了，其实最常出问题的是自动加载没生效。快速验证方法：
- 在项目根写个
test.php：
<?php
require __DIR__ . '/vendor/autoload.php';
var_dump(class_exists('AppExample'));
如果输出 bool(false)，说明 PSR-4 映射路径或命名空间写错了，不是 Composer 没装好。
复杂点在于：路径是相对于 composer.json 所在位置解析的，不是相对于 autoload.php；而命名空间里的双反斜杠在 JSON 里要写成单个，PHP 里引用时又得还原成双反斜杠——这种细节不亲手试一次，光看文档很难意识到。
