options.symlink 仅尝试启用符号链接而非保证成功，实际是否创建取决于系统权限、本地包自身composer.json是否含该配置、以及Composer版本≥2.2；失败时静默回退为复制，需用ls -la或dir验证是否真生效。
options.symlink 控制的是链接行为，不是开关
很多人以为加了 "symlink": true 就一定能创建符号链接，其实它只是“尝试启用”，成败取决于系统能力、权限和本地包自身配置。Composer 在 path 类型仓库中默认会尝试 symlink，但失败时静默 fallback 到 copy —— 你看到 vendor 里是普通文件夹，不代表配置错了，而是 symlink 创建被跳过了。
关键判断点有三个：
- 本地包自己的
composer.json是否包含"options": {"symlink": true}（主项目 repositories 里配不配，都不如这句管用） - Windows 用户是否以管理员身份运行终端，或已启用“开发者模式”
- Docker 场景下是否加了
--cap-add=SYS_ADMIN，且挂载方式支持符号链接
验证是否真生效：Linux/macOS 运行 ls -la vendor/vendor/name，输出含 -> 才算成功；Windows 用 dir vendor\vendor\name，看到“JUNCTION”或“快捷方式”字样才行。
options.versions 是临时覆盖版本号的唯一可靠方式
path 仓库下的包默认忽略 version 字段，只认当前 Git HEAD 所在分支名（比如 dev-main）。但如果你本地包没切到目标分支，又不想动 Git，可以用 "versions" 显式映射：
"repositories": [
{
"type": "path",
"url": "../my-pkg",
"options": {
"symlink": true,
"versions": {
"acme/utils": "dev-feature-x"
}
}
}
]
这样即使本地包当前在 main 分支，composer require acme/utils:dev-feature-x 也能匹配上。注意："versions" 的 key 必须和 require 字符串完全一致，包括大小写和短横线。
常见误操作：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在本地包
composer.json里改version字段 → 无效，path 源下 version 被无视 - 在主项目
require中写"acme/utils": "1.0.0"→ 报错，path 源不支持稳定版约束 - 把
"versions"写在主项目根级config或extra里 → 不生效，必须嵌套在对应 repository 条目内
不配 options 时的 fallback 行为比想象中更隐蔽
很多开发者发现改了本地代码，项目里没反应，第一反应是 autoload 没更新，于是狂跑 composer dump-autoload -o。其实问题根本不在 autoload —— 如果 symlink 失败 fallback 成 copy，那 vendor 目录里压根就是一份旧副本，autoload 再怎么刷新也映射不到新代码。
这种 fallback 是静默的：没有 warning，没有 error，composer update 也不报异常。你只能靠文件系统层面验证：
-
ls -la vendor/acme/utils输出是普通目录结构 → fallback 成 copy - 对比
vendor/acme/utils/src/Helper.php和../my-pkg/src/Helper.php的修改时间 → 不一致就确认是 copy - 执行
composer show acme/utils看 source.type 是path还是dist→ 若是dist，说明已 fallback
这时候别修 autoload，先修 symlink 条件：检查本地包 composer.json 有没有 "options": {"symlink": true}，再看系统权限和路径合法性。
options 在不同 Composer 版本中的兼容性差异
"options" 字段从 Composer 2.2 开始才被 path 类型仓库正式支持。低于这个版本（比如 2.1.x），即使写了也会被忽略，且无提示。这也是为什么有些老项目死活不生效——不是配置错，是版本卡住了。
验证方式很简单：
- 运行
composer --version，确认 ≥ 2.2 - 检查
composer.lock中该包的source.type字段：若为path，说明识别成功；若为dist或压根没这条记录，大概率是版本太低或 options 未被解析
另一个容易被忽略的点："options" 只对 path 类型仓库有效，写在 vcs 或 package 类型里会被直接忽略，不会报错也不会警告。
