可行但需满足路径存在、name对齐、symlink启用三条件，否则报错或不生效；repositories须在主项目中配置，path应为相对路径并加@dev，启用symlink需配置options且Windows需管理员权限，生产环境须移除path配置。
直接用 path 类型仓库替代远程依赖是可行的，但必须满足“路径存在 + name 对齐 + symlink 启用”三个硬条件，否则你会看到 Could not find package 或改了代码不生效——这不是 Composer 不支持，而是它根本没把你的本地目录当包看。
为什么 composer require vendor/name 会失败
Composer 不会自动扫描硬盘找包，它只按 repositories 数组里写的路径去读取 composer.json。常见失败原因：
-
repositories没写进主项目（即你正在运行composer命令的那个项目的）composer.json，而是误加到了本地包自己的composer.json里 - 本地包根目录下没有
composer.json，或有但name字段写成了MyOrg/Auth（含大写字母），而require写的是myorg/auth -
url写成绝对路径（如C:/dev/my-pkg），Windows 下容易静默失效；应统一用相对路径，如"../packages/auth" - 漏写了
@dev后缀：即使配置了path，composer require myorg/auth仍会去 Packagist 找稳定版；必须写composer require myorg/auth:dev-main@dev
path 仓库下如何让修改立即生效
默认行为是创建符号链接（symlink），但这个动作不会自动触发——它只在 composer require 或 composer update vendor/name 时发生。关键点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须在主项目
composer.json的repositories条目里加"options": {"symlink": true}，或者在本地包自己的composer.json里加同样字段 - Linux/macOS 一般没问题；Windows 需以管理员权限运行终端，否则
symlink创建失败且无提示 - Docker 场景要加
--cap-add=SYS_ADMIN，且挂载方式需支持 symlink（如-v $(pwd)/packages:/app/packages） - 验证是否真链接成功：
ls -la vendor/myorg/auth（Linux/macOS）或dir vendor\myorg\auth（Windows），看到->或 “快捷方式” 才算对
生产部署时怎么避免 path 报错
生产服务器上不存在 ../packages/auth 这种路径，composer install 会直接中断，不会 fallback 到远程源。不能靠“删掉再重装”来绕过：
- CI/CD 构建阶段必须移除
repositories中所有type: "path"条目，只保留远程源（如 Packagist 或私有镜像） - 不要手动编辑
composer.json来切换环境，推荐用composer config动态覆盖，或用 Studio 工具管理本地覆盖 - 确保所有
path包都有对应的远程发布（GitHub + Packagist / 私有源），否则生产构建无法还原依赖 - 如果必须保留
path配置，可在部署脚本中用sed或jq清洗掉repositories，再执行composer install --no-dev
最常被忽略的一点：即使启用了 symlink，autoload 映射也不会自动更新——类能否 new 或 use，取决于 vendor/composer/autoload_psr4.php 是否包含你本地包的真实路径。这和 composer dump-autoload 无关，只和本地包 composer.json 里的 autoload.psr-4 字段是否正确有关，且末尾不能多斜杠。
