答案是name或路径不匹配导致静默失败：必须主项目声明repositories、本地包含合法composer.json、require的name/version严格对齐，缺一则Composer跳过path源直查Packagist。
能直接用，但必须同时满足三个硬条件：主项目声明 repositories、本地包有合法 composer.json、require 中的 name 和 version 与之严格对齐——缺一不可，否则静默失败。
为什么 composer require 报 “Could not find package”
这不是网络问题，90% 是 name 或路径没对上。Composer 不会提示“你配错了”，而是直接跳过 path 仓库，转头去 Packagist 找包，自然找不到。
-
name必须大小写、分隔符（仅短横线-）、vendor 前缀完全一致，"acme/utils"≠"Acme/utils"≠"acme_utils" -
url指向的是**含composer.json的目录**，不是文件本身；末尾不能带/，"../my-pkg/"会被静默忽略 - 路径是相对于主项目
composer.json的位置算起，不是 shell 当前目录；~、$HOME、file://全部不识别 - 本地包根目录下必须存在语法合法的
composer.json（无尾逗号、全双引号），缺name或version字段也会被跳过
require 写了但 vendor 里还是远程包
说明 path 仓库根本没生效，或者虽然生效但 fallback 到了 copy 模式——改本地代码不会立刻反映到主项目中。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确认你运行的是
composer update，不是composer install；path 仓库只在update时重建链接 - Linux/macOS 下检查：
ls -la vendor/acme/utils，输出含->才是 symlink；Windows 下用dir vendorcmeutils看是否为JUNCTION - symlink 是否启用，**取决于本地包自己的
composer.json是否含"options": {"symlink": true}**，主项目配这个没用 - Windows 需以管理员权限运行终端；Docker 容器需加
--cap-add=SYS_ADMIN并确保挂载支持 symlink
类 use 不了，autoload 失效
vendor 目录里有包，但 PHP 找不到类——这不是 Composer 没装，而是 autoload 映射没加载或路径不对。
- 本地包的
composer.json必须定义autoload（如"psr-4": {"Acme\Utils\": "src/"}），否则即使安装成功也无法自动加载 - 主项目执行
composer dump-autoload -o可强制刷新合并后的自动加载映射 - IDE（如 PHPStorm）断点不命中？检查 IDE 中配置的路径是否和磁盘真实路径一致；符号链接下，部分 IDE 默认不跟随 symlink，需手动开启“Follow symlinks”
团队协作或 CI 场景下怎么避免路径硬编码
把 "../my-pkg" 这种路径写死在 composer.json 里，换机器就崩，CI 构建也会失败。
- 别用
composer config repo.path做项目级配置——它只影响当前终端会话，CI 或他人 clone 后不生效 - 推荐方案：用环境变量 + 自定义脚本生成临时
composer.json，或用 Makefile / npm script 封装composer update流程 - 更稳妥的做法：CI 中统一用
composer config --local动态注入 path 仓库，并确保所有开发者都使用同一套路径约定（如固定放在./packages/下） - 切记：path 仓库只用于开发联调，上线前必须移除或替换为正式版本约束，否则部署环境无法还原
最隐蔽的问题永远是 symlink 没真正建立——你以为改了就生效，其实 vendor 里还是旧副本。每次怀疑行为异常，第一件事就是 ls -la vendor/xxx 看一眼是不是箭头。
