必须在项目根目录composer.json的repositories数组中显式声明{"type":"path","url":"./packages/my-utils"}，且本地包composer.json的name须与require完全一致；改代码后需执行composer update vendor/name刷新链接。
composer.json 的 repositories 字段必须显式声明 path 类型源
Composer 不会自动扫描硬盘找本地包，repositories 是唯一入口。漏配、错配或写在错误位置（比如写进本地包自己的 composer.json），composer install 就完全无视你本地的代码。
必须在**项目根目录的 composer.json** 中写成数组形式：
{
"repositories": [
{
"type": "path",
"url": "./packages/my-utils"
}
],
"require": {
"myorg/utils": "dev-main"
}
}
-
url推荐用相对路径（从当前composer.json算起），绝对路径在 Windows 或 CI 环境下极易静默失败 -
url指向的是**目录**，不是composer.json文件本身 - 该目录下必须存在合法的
composer.json，且其中name字段（如"myorg/utils"）要和require里写的**完全一致**（大小写敏感） - 如果本地包没打 tag，
version字段可写"dev-main"，但 require 时仍要用"dev-main"，不能写"*"或"^1.0"
本地包改了代码，为什么 vendor 里没更新
因为 composer install 不刷新已有链接——它只补全缺失的 symlink。你看到的 vendor/myorg/utils 默认是符号链接（Linux/macOS）或复制（Windows），但它的目标路径不会随本地代码改动而自动重连。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 改完本地包代码后，必须运行
composer update myorg/utils（指定包名），不是composer install -
composer update无参数会全量重算，慢且可能意外升级其他依赖；指定包名更快、更安全 - 验证是否真为链接：Linux/macOS 下执行
ls -la vendor/myorg/utils，输出应含->；Windows 下用dir vendor\myorg\utils看是否为“快捷方式” - 若想强制复制而非链接（比如 CI 环境），在
repositories条目中加"options": {"symlink": false}
Windows 上 symlink 创建失败却不报错
Windows 默认不支持创建符号链接，composer update 会悄悄 fallback 到复制行为，导致你改了本地代码，vendor/ 里还是旧文件——现象就是“改了不生效”，但命令行没有任何提示。
- 启用开发者模式（设置 → 更新与安全 → 针对开发人员 → 开发者模式）
- 或以管理员权限运行终端（右键“命令提示符” → “以管理员身份运行”）
- 也可以在
repositories中显式加"options": {"symlink": true}，让 Composer 明确尝试创建链接，失败时抛出错误，而不是静默降级 - CI/CD 环境无法启用 symlink，务必在上线前移除
repositories中的path条目，否则构建必然失败
require 字段不能直接写路径，这是最常见硬伤
有人试图这么写："myorg/utils": "./packages/my-utils" —— 这是无效的。require 只接受 vendor/name:version 格式，不解析路径值。Composer 会直接忽略这个字段，转而去 Packagist 查找，结果就是 Could not find a matching version of package myorg/utils。
- 正确做法只有两个：一是在
repositories中声明path源；二是用composer require myorg/utils:dev-main触发安装 - 不存在“本地 require”的语法糖，也别用
--repository-url=file://...这种绕路方式，配置repositories更清晰、可复现 - 如果团队协作，避免写死绝对路径；用
../packages/my-utils这类相对路径，配合 git 提交，新成员拉下来就能直接用
真正卡住人的，往往不是“怎么配”，而是“配完以为好了，其实没生效”，尤其是 symlink 在 Windows 上静默 fallback、路径写成绝对路径、或者 require 和 name 大小写不一致——这些地方不验证，就永远在猜。
