composer init 是最快生成 composer.json 的方式，但仅创建配置文件，不安装依赖、不建 vendor 目录、不配置 autoload；需立即补全 autoload、校验 require 兼容性、运行 composer install 才能正常使用。
直接用 composer init 生成 composer.json 是最快方式，但它只写配置、不装包、不建目录、不配自动加载——你得立刻补三步，否则下一步 composer install 就会失败或类找不到。
composer init 卡在 Package name 怎么办
它会尝试从当前目录名自动推导包名，但校验极严：必须全小写、只含字母数字/连字符/下划线、不能以数字开头、不能有空格或中文。目录叫 My App 或 api_v2!，命令就卡住不动。
- 初始化前先重命名目录：
mv "My App" my-app - 跳过自动推导，显式指定：
composer init --name="myorg/myapp" --no-interaction - 已卡住？按
Ctrl+C中断，别等，再带参数重试
autoload 不生效的常见原因
composer init 默认不问 PSR-4，也不写 autoload 字段。你填了 "App": "src/" 却还是 Class not found，大概率是字段没加、路径错位或没刷新加载器。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 手动编辑
composer.json，加入这段（注意命名空间末尾是双反斜杠）："autoload": { "psr-4": { "App\": "src/" } } - 路径必须相对于项目根目录，填
src/可以，填./src/或绝对路径会失效 - 改完立刻运行
composer dump-autoload，否则不生效 - 如果类实际在
lib/下，"App\": "src/"必须同步改成"App\": "lib/"
require 里写 php:^8.1 为什么 install 失败
不是网络问题，是约束和环境对不上。php:^8.1 表示“PHP 8.1.x 或更高兼容版本”，但如果你本地是 PHP 7.4，composer install 就直接退出，不报错也不提示。
- 先确认真实环境：
composer show --platform看输出里的php行 -
require里别写php >=8.1，必须用语义化版本符：php:^8.1或php:~8.1.0 - 加第三方包时别贪快，比如填
monolog/monolog:^1.0——它最高只支持 PHP 7.4，在 PHP 8.1 下必然失败 - 老项目升级 PHP 前，先改
composer.json里的require.php，再composer update
最容易被忽略的是：composer.json 必须放在你运行命令的当前工作目录，Composer 不会向上查找；type 字段漏写或写错（比如该写 project 却留默认 library），会导致某些依赖或脚本行为异常，且不报错。
