本地测试 composer install 报错主因是 path 类型仓库配置错误：repositories 必须写在主项目 composer.json 顶层，路径需可访问且含合法 composer.json，require 版本须用 dev-main 等分支名而非 *，vendor 中软链正常。
本地测试时 composer install 报错，大概率不是网络或权限问题，而是 path 类型仓库配置没对齐、环境不匹配，或符号链接机制被误判为“没装上”——它其实装了，只是你没认出来。
本地包路径配置写在哪？必须是项目根 composer.json
很多人把 repositories 塞进本地包自己的 composer.json 里，结果毫无作用。Composer 只在执行命令的那个项目（即你 cd 进去的目录）的 composer.json 中读取 repositories 配置。
-
repositories必须写在主项目的composer.json顶层，不能嵌套在require或其他字段下 - 类型固定为
"type": "path"，路径值支持相对路径（如"../my-package"）或绝对路径（如"/var/www/my-package"），但不能含~或$HOME - 路径必须可访问：PHP 进程得能
is_dir()到该目录，SELinux 或 Docker volume 权限不足会导致静默失败 - 本地包目录下必须有合法的
composer.json，且其中name字段（如"acme/utils"）要和你在主项目中require的完全一致
require 版本写 dev-main 而不是 * 或 ^1.0
Path 源下的包不走语义化版本解析，它只认 Git 分支名。即使你本地包 composer.json 里写了 "version": "1.0.0"，Composer 也直接忽略。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确保本地包目录已运行过
git init，且至少有一个 commit（否则 Composer 直接跳过） - 如果默认分支是
main，require写"acme/utils": "dev-main"；如果是develop，就得写"dev-develop" - 不要用
"*"—— 它会触发全量依赖解析，可能绕过 path 源，去远程找包 - 执行
composer update acme/utils单独更新这个包，避免composer update顺手刷掉其他锁定版本
install 后 vendor 里是软链 ≠ 没成功
看到 vendor/acme/utils 是个箭头（->）指向外部目录，不是 bug，是 path 源的正常行为。这是为了热更新：你改本地包代码，主项目立刻生效，不用反复 install。
- Linux/macOS 下用
ls -l vendor/acme/utils看是否显示类似acme/utils -> /path/to/my-package - 如果是个普通文件夹，说明配置未生效，Composer fallback 到了其他源（比如 packagist），检查
composer show acme/utils输出的 source 类型是不是path - Windows 用户注意：启用开发者模式或管理员权限才能创建符号链接，否则 Composer 会退化为复制（但不会报错）
- CI/CD 场景慎用 path 源——构建机通常没那个本地路径，应改用
dist+archive或私有 Satis 仓库
报 “Could not find package” 的真实原因
这个错误几乎从不因为“找不到文件”，而是校验链上某环断了：路径存在但不可读、composer.json 缺 name、Git 分支名对不上、PHP 用户无权访问目标目录。
- 先跑
composer diagnose，它会检查路径是否存在、是否可读、是否含有效 JSON - 手动
cat ../my-package/composer.json | jq '.name'确认 name 值无空格、大小写完全匹配 - 检查本地包目录的 Git HEAD：运行
git branch --show-current，确保和require的分支名一致 - 如果用了 Docker，宿主机路径映射进容器后，路径在容器内是否仍可达？用
docker exec -it app ls -l /app/../my-package验证
最常被忽略的一点：路径依赖生效后，vendor/autoload.php 会自动包含本地包的 autoload 配置，但如果你手动修改过 autoload 或用了 classmap 手动注册，可能覆盖路径包的自动发现——别动 autoload，让 Composer 自己来。
