答案：根本原因是repositories未在主项目composer.json中正确定义、本地包name与require不完全匹配、路径非相对或末尾含/、缺少合法composer.json或未启用symlink。
直接装不上、改了代码不生效、require报“Could not find package”——这些问题不是 Composer 坏了，而是本地 path 仓库没对齐。核心就三点：主项目 composer.json 里写对 repositories，本地包目录下有合法 composer.json 且 name 和 require 完全一致，版本必须用 dev-main 这类分支名。
怎么配 repositories 才让 Composer “看见”本地包
必须在主项目的根目录 composer.json 中配置，不能写在本地包自己的文件里。Composer 只扫描这个数组，不猜路径、不递归查找。
-
repositories是数组，哪怕只加一个也要写成[{"type": "path", "url": "../my-pkg"}] -
url必须是相对路径（如"../packages/utils"），Windows 上用绝对路径（如"C:/work/my-pkg"）大概率静默失败 -
url指向的是**目录**，该目录下必须存在composer.json，且里面含name字段（如"acme/utils"） - 如果用了通配符（如
"../packages/*"），每个匹配子目录都得有独立的composer.json
为什么 composer require vendor/name:dev-main 报 “Could not find package”
根本不是缓存或网络问题，是 Composer 根本没去那个目录看。它只按 repositories 列表加载源，require 字段只声明“我要谁”，不指定“去哪找”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
require中的包名必须和本地包composer.json里的name**完全一致**（大小写敏感、vendor 名不能少） - 版本必须写
dev-main、dev-develop这类 Git 分支名，不能写"1.0.0"或"*"；path 源下version字段被忽略 - 本地包目录必须已执行过
git init并至少有一个commit，否则 Composer 直接跳过 -
repositories写错位置（比如写进了本地包自己的composer.json）是最常见错误
改了本地代码，为什么主项目里不生效
默认行为是复制（copy），不是符号链接（symlink）。你改的是 ../my-pkg/src/Helper.php，但 vendor/acme/utils/src/Helper.php 还是旧文件。
- 启用 symlink：在
repositories条目中加"options": {"symlink": true} - Linux/macOS 通常默认支持；Windows 必须显式写，并开启“开发者模式”或以管理员权限运行命令行
-
composer install不刷新已有链接，只补缺；必须运行composer update acme/utils才会重建 symlink - 验证是否成功：
ls -la vendor/acme/utils应显示-> ../my-pkg（Linux/macOS）；Windows 上用dir vendorcmeutils看是否为“快捷方式”类型
要不要 git init？本地包的 composer.json 有哪些硬性要求
要。Composer 对 path 类型源的校验很严格：没 git init + commit，它就当这个目录不存在。
- 本地包
composer.json至少要有name、autoload（推荐 PSR-4）、type（通常是"library"） -
autoload必须映射到真实存在的目录，比如"Hoo\Tool\": "src/"，且src/下要有对应命名空间的 PHP 文件 - 不要漏掉
minimum-stability，开发阶段设为"dev"，否则dev-main会被拒绝 - 如果用 Laravel，还需确保服务提供者类路径正确，并在
config/app.php的providers数组中注册
最容易被忽略的是：本地包目录没 git commit，或者 repositories 配在了错误的 composer.json 里。这两点一错，后面所有操作都是徒劳。
