composer init 仅生成含基础元信息的 composer.json，不配置 autoload、type 和 require，必须手动补全三者，否则类无法加载、包不可用、Laravel 自动发现失效。
直接说结论：用 composer init 启动项目最省事，但必须立刻补全 autoload、type 和 require 三个字段，否则后续类根本不会被加载，包也装不进任何项目。
为什么 composer init 生成的 composer.json 不能直接用
它默认只填了基础元信息，比如 name、description、license，但关键的自动加载规则和类型声明全靠你手动加。不补的话：
• Laravel 项目里 composer require 进去后，use AcmeDemoDemoServiceProvider 会报 Class not found
• PHP CLI 下直接 php index.php 也会失败，因为 autoload 没配，PSR-4 映射压根没生效
• 如果是 Laravel 包，还缺 "type": "laravel-package"，自动发现机制就完全不触发
必须补全的三个核心字段怎么写
以一个叫 acme/demo 的 Laravel 扩展包为例：
-
"type": "laravel-package"—— 不是强制但强烈建议，否则 Laravel 10+ 的package:discover会跳过它 -
"autoload": {"psr-4": {"Acme\Demo\": "src/"}}—— 命名空间和目录必须严格对应，反斜杠要双写，路径末尾不加斜杠 -
"require": {"php": "^8.1"}—— Laravel 10+ 已弃用 PHP 8.0，硬写">=8.0"会导致别人安装时报Your requirements could not be resolved
如果只是通用库（非 Laravel），type 改成 "library" 即可，但 autoload 和 require 同样不可少。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
本地开发时怎么让主项目实时读取修改
别信“改完代码跑 composer dump-autoload 就行”——那对本地 path 仓库完全无效。真正起作用的是这三步：
- 在主项目的
composer.json的repositories数组里加一条：{"type": "path", "url": "../acme-demo"}（注意是相对路径，不是绝对路径） - 确保本地包目录下有合法
composer.json，且name字段和require里写的完全一致（包括大小写） - 执行
composer require acme/demo:@dev，然后每次改完本地代码，只需在主项目里运行composer update acme/demo—— 它会刷新 symlink 目标，不是重装
Windows 用户额外注意："options": {"symlink": true} 必须显式加上，否则默认不创建符号链接，改代码等于白改。
发布前最容易漏掉的致命配置
很多包上传 Packagist 后别人 composer require 失败，90% 是因为这几个点没检查：
- 本地包没
git init+ 至少一个commit—— Composer 会直接跳过该目录，报Could not find package -
composer.json里minimum-stability是dev，但没配prefer-stable: true，导致别人项目里require时拉不到dev-main - 用了
path仓库但忘了删掉repositories配置就直接 push 到 GitHub —— 别人 clone 后根本找不到源
真正麻烦的从来不是写代码，而是 name、url、@dev 这三者在三个地方（主项目 composer.json、本地包 composer.json、require 命令）必须严丝合缝，差一个字符或大小写，整个链路就断了。
