本地包autoload配置必须显式写入主项目composer.json的autoload字段，不能依赖子包自身配置；路径须相对主项目根目录，改后必须执行composer dump-autoload -o生效。
本地包的 autoload 配置必须显式声明在主项目 composer.json 中
Composer 不会自动扫描子目录下的 composer.json 来合并 autoload 规则。如果你把私有包放在 packages/my-sdk，哪怕它自己有 "autoload": {"psr-4": {"MySdk\": "src/"}}，主项目也完全“看不见”这个映射 —— 类加载时直接 Class not found。
正确做法是：在主项目的 composer.json 的 autoload 或 autoload-dev 里显式添加路径：
- PSR-4 映射需写全命名空间前缀，例如：
"MySdk\": "packages/my-sdk/src/" - 路径必须是相对于主项目根目录的，不能用
../或绝对路径 - 改完立刻运行
composer dump-autoload -o，否则新映射不生效
path 类型仓库下，本地包的 require 冲突不会出现在主项目 why-not 输出中
当你用 "repositories": [{"type": "path", "url": "./packages/my-sdk"}] 引入本地包，它的依赖约束只存在于 packages/my-sdk/composer.json 里。主项目执行 composer why-not guzzlehttp/guzzle:^8.0 会返回空，因为 Composer 默认只查主项目声明的约束和已安装包元数据。
必须切换到本地包目录排查：
cd packages/my-sdk- 再运行
composer why-not guzzlehttp/guzzle:^8.0 - 如果输出类似
my-sdk dev-main requires guzzlehttp/guzzle "7.4.5"，说明冲突源头就在它自己钉死的版本
这时要改的是 packages/my-sdk/composer.json 里的 require 字段，而不是主项目。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
避免 autoload 重复注册：别让本地包和 vendor 包共用同一命名空间
常见错误是本地包和某个已安装的 vendor 包（比如 monolog/monolog）都声明了 "Monolog\": "src/" 这类映射。Composer 会把两者都写进 vendor/composer/autoload_psr4.php，运行时按注册顺序加载 —— 后注册的覆盖前注册的，但类文件物理路径不同，极易出现方法不存在或 trait 冲突。
解决方式很直接：
- 检查本地包的命名空间是否与现有 vendor 包重名，尤其是通用前缀如
App\、Helper\、Utils\ - 本地包务必使用唯一命名空间，例如
MyCompany\MySdk\，并在composer.json中严格对应 - 运行
composer dump-autoload -o --no-dev后，打开vendor/composer/autoload_psr4.php手动确认没有重复键
清理残留 autoload 缓存比重装 vendor 更有效
本地包修改后，经常出现“改了命名空间却还是加载旧类”的现象。这不是 Composer 没生效，而是 vendor/composer/autoload_*.php 文件里缓存了旧映射，且 dump-autoload 默认不覆盖已有文件中的旧条目。
安全清理步骤：
- 删掉整个
vendor/composer/目录（不是删vendor/） - 运行
composer dump-autoload -o - 验证：
grep -r "MySdk\\" vendor/composer/应只返回一行，且路径正确
这比反复 composer install 或清 vendor/ 快得多，也更可控 —— 因为 autoload 映射是静态生成的，不重建就永远走不通。
