repositories 必须置于主项目 composer.json 根层级，与 require 同级；url 须为相对路径且指向含合法 composer.json 的目录；本地包 name 和 require 必须逐字匹配；symlink 生效依赖本地包自身 composer.json 中 "options": {"symlink": true} 配置。
repositories 必须写在主项目 composer.json 根层级
Composer 只读取主项目 composer.json 最外层的 repositories 字段，写在 require、autoload、extra 或任何嵌套结构里都无效。一旦放错位置，composer install 会完全无视该配置，且不报错、不警告。
常见错误包括：
- 把
repositories塞进"config": {...}里 - 误以为本地包自己的
composer.json里写repositories能被主项目继承 - 用
composer config repositories.xxx命令写进全局配置（~/.composer/config.json），但主项目没启用repositories的全局继承（默认关闭）
正确做法：直接编辑主项目根目录下的 composer.json，确保 repositories 和 require 同级，例如：
{
"repositories": [
{
"type": "path",
"url": "../my-utils"
}
],
"require": {
"acme/utils": "*"
}
}
url 必须是相对路径且指向含 composer.json 的目录
url 不接受绝对路径、~、./ 缺失、file://、尾部斜杠（如 "../pkg/"）——这些都会导致 Composer 静默跳过整个仓库条目。
必须满足：
- 以
./或../开头（如"../shared-lib"、"./packages/logger"） - 路径终点是一个**目录**，且该目录下存在合法的
composer.json文件（语法正确、无尾逗号、全双引号） - 不能指向
composer.json文件本身，也不能是空目录
验证方式：在主项目根目录运行 ls -la ../my-utils/composer.json（Linux/macOS）或 dir ..\my-utils\composer.json（Windows），确认文件真实存在。
本地包的 name 和 version 必须与 require 严格匹配
Composer 对 name 大小写、分隔符（仅允许短横线 -）、vendor 名全部敏感。写错一个字符，composer require acme/utils:dev-main 就会报 Could not find package，且 composer show --all 里根本不会列出它。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
关键点：
- 本地包
composer.json中的"name": "acme/utils"必须和require中的字符串逐字一致（"Acme/Utils"❌，"acme_utils"❌） -
require中的版本必须显式指定："*"是最安全的选择；dev-main也可用，但前提是本地包 Git 仓库已初始化并至少有一个 commit（git init && git add . && git commit -m "init"） - 不要写
^1.0、~1.2或1.2.3—— path 类型仓库不解析语义化版本，这些约束会被忽略甚至触发 warning
symlink 生效靠本地包自己的 options 配置，不是主项目
想让 vendor/acme/utils 变成符号链接（改源码立刻生效），关键不在主项目配什么，而在本地包自己的 composer.json 里是否声明了：
"options": {
"symlink": true
}
缺这句，Composer 默认 fallback 到复制（copy）模式，你改了 ../my-utils/src/Helper.php，vendor/acme/utils/src/Helper.php 还是旧文件。
注意平台差异：
- Linux/macOS：通常能自动建 symlink，但需确认用户有权限
- Windows：必须以管理员身份运行终端，否则创建失败且无提示
- Docker：需加
--cap-add=SYS_ADMIN，且挂载方式要支持 symlink（如-v $(pwd)/../my-utils:/src/my-utils）
验证是否真链接成功：readlink vendor/acme/utils（Linux/macOS）或 dir vendor\acme\utils（Windows），看到 -> 或 JUNCTION 才算对。否则就是 fallback 了，立刻检查本地包 composer.json 是否漏掉 options 段。
