本地包需通过path仓库配置、包内autoload声明及主项目dump-autoload三步闭环才能自动加载；缺一不可，否则类无法找到。
本地包能被自动加载，前提是它被 Composer 正确识别为一个“包”，而不是普通目录；直接复制进 vendor/ 或手动 require 无效，必须走 path 仓库 + 包内 autoload 配置 + 主项目 dump-autoload 三步闭环。
path 仓库配置必须写在主项目 composer.json 顶层
Composer 不会自动扫描子目录下的包，必须显式声明源。错误做法是把包放 vendor/acme/my-utils 后指望它自己工作——composer install 会清空整个 vendor/，且不注册 autoload。
-
repositories必须是主项目composer.json的顶层字段，不是嵌套在autoload或其他地方 - 格式必须是数组：
[{ "type": "path", "url": "./packages/my-utils" }]，url用相对路径（推荐），不能带file://、~/或未转义的 Windows 反斜杠 - 目标目录（如
./packages/my-utils）下必须有合法composer.json，含"name": "acme/my-utils"和可识别版本（如"dev-main"） - 该目录需已执行
git init并至少有一个 commit，否则 Composer 拒绝读取
本地包自身的 autoload 必须独立配置
主项目的 autoload 对本地包无效——Composer 加载类时，只读取**被 require 的包自身 composer.json 中的 autoload 段**。常见错误是只配了主项目 PSR-4，却忘了在本地包里也写。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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": {"Acme\Utils\": "src/"} - 命名空间末尾双反斜杠
\不可省略，路径用正斜杠结尾（"src/"），大小写与文件系统严格一致 - 路径是相对于本地包根目录的，不是主项目根目录：别写成
"src/Acme/Utils/"，那是错的 - 改完本地包的
autoload后，在主项目中必须运行composer dump-autoload，否则新映射不会写入vendor/composer/autoload_psr4.php
require 必须用 dev-分支名，不能用版本号或通配符
Path 仓库不走语义化版本解析，Composer 只认当前 Git HEAD 所在分支名。写错就找不到包，不是报错“版本不匹配”，而是直接跳过。
- require 字段必须显式写
"acme/my-utils": "dev-main"（大小写必须与实际分支名完全一致） - 不能写
"^1.0"、"*"或"dev-main as 1.0"，这些都会导致Could not find a matching version of package - 如果本地包切到了
develop分支，require也得同步改成"dev-develop"，否则仍加载旧分支的代码 - 执行
composer update acme/my-utils可强制刷新该包的引用，比全量update更安全
类找不到？先确认 autoload_psr4.php 是否包含你的映射
90% 的 “Class not found” 问题，根源不在路径或命名空间拼写，而在于映射根本没生成。不要凭感觉调试，直接查生成文件。
- 打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如'Acme\Utils\'），看对应路径是否正确 - 如果没出现，说明
composer dump-autoload没执行，或本地包的composer.json路径/内容有硬伤（比如 JSON 格式错误、autoload缩进不对） - 如果出现了但路径指向错误目录，检查本地包
composer.json中的路径值是否多写了./、少写了尾部/，或用了反斜杠 - Windows 下若路径用了未转义的
（如"srcUtils"），JSON 解析可能失败，生成为空字符串——一律用/
最易被忽略的是：本地包的 autoload 配置和主项目的 dump-autoload 是解耦的两件事，改了包不重生成，等于没改。
