composer加载本地包必须在主项目composer.json根级repositories中声明type为"path"的仓库，url用相对路径指向含合法composer.json的本地目录，且require的包名须与本地包name严格一致。
path仓库配置必须写在根composer.json的repositories里
Composer不会自动扫描子目录或猜路径，所有本地包都得显式声明。你不能只在子模块里写composer.json就指望主项目识别——主项目的composer.json里必须有repositories字段，且每个条目type设为"path"，url指向该模块所在目录（相对路径优先）。
常见错误现象：Could not find a matching version of package vendor/name——八成是漏了repositories，或者url写成绝对路径、~/开头、或直接指向了composer.json文件而非其所在目录。
-
url值必须是目录，比如"modules/logging"，不是"modules/logging/composer.json" - 每个被引用的本地目录下，必须存在合法的
composer.json，至少含name和autoload（哪怕空 autoload 也行） - 主项目
require中的包名（如"myteam/logging"）必须与本地包composer.json里的name字段**逐字符一致**，包括大小写和斜杠方向
本地开发要软链接，得靠options.symlink或全局配置
默认情况下，composer install对path仓库会复制文件进vendor/，改本地代码根本没用。想边写边测，必须启用符号链接。但这个开关不在主项目配置里，而在本地包自己的composer.json中加"options": {"symlink": true}，或者全局执行：composer config --global path.repo.symlink true。
注意：只有composer update vendor/name会重建链接，install不会刷新已有链接。改完本地代码后运行install，什么也不会发生。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Linux/macOS 默认支持软链；Windows 需开启“开发者模式”或以管理员身份运行终端
- 验证是否生效：执行
ls -la vendor/vendor/name（Linux/macOS）或dir vendor endor ame（Windows），输出里应含->或<symlink></symlink> - 如果仍不链接，检查 Composer 版本是否 ≥ 2.2（旧版不支持
options.symlink）
autoload映射必须在本地包自身composer.json里定义
主项目autoload字段管不到vendor/外的代码，所以每个本地包必须自己声明autoload规则。PSR-4 是最稳妥的选择，比如"MyTeam\Logging\": "src/"，然后确保类文件放在src/下对应命名空间路径。
常见错误现象：类能被require但调用时报Class not found——大概率是本地包composer.json里没写autoload，或路径写错（比如写成"src/Logging/"却把类放在src/Handler.php里）。
- 改完
autoload后，必须运行composer dump-autoload（在主项目或本地包目录下都行，只要覆盖到该包） - 不要在主项目
autoload里手动加psr-4映射去“绕过”本地包配置——这会导致类加载冲突，尤其多个包共用同一命名空间前缀时 - 本地包若含
scripts（如post-install-cmd），只有用path仓库才能触发；package类型仓库不支持脚本执行
生产部署前必须移除path仓库配置
CI/CD 流水线跑composer install时，path仓库指定的本地路径几乎肯定不存在，Composer 会直接报错退出，不会自动 fallback 到 Packagist 或私有仓库。这不是 bug，是设计使然：它拒绝隐式行为，强制你明确依赖来源。
团队协作时，repositories里写死"../my-local-package"这种路径极易导致队友拉代码后立刻失败。更可靠的做法是：用环境变量或构建脚本动态注入，或干脆用studio这类工具管理本地覆盖，让composer.json保持干净。
- 上线前检查点：确认
composer.lock里没有"source": {"type": "path", ...}字段（若有，说明上次update用了本地路径） - 推荐流程：开发用
path+symlink；发布前推送到私有 Packagist（如 Satis）或 GitHub Release；生产构建时删掉repositories中所有path条目，只留vcs或composer类型源 - 千万别把
path配置提交到主干分支——它只属于你个人开发环境
