答案：Composer默认不信任本地路径，需在项目composer.json中显式配置"type": "path"的repositories，且本地包必须含合法composer.json、name字段与require完全一致、Git已初始化并提交。
composer install 报“Could not find package”但本地包明明存在
不是路径写错，也不是没加 repositories，而是 Composer 默认不信任本地文件系统路径——它要求你显式声明类型为 "path"，且本地包目录下必须有合法的 composer.json，其中 name 字段要和你在项目中 require 的完全一致（包括 vendor 名）。
常见错误现象：
-
composer install提示Could not find package vendor/name at any version，但ls ../my-local-package/composer.json确实存在 - 本地包目录未初始化 Git 仓库，或只有空目录、没 commit，Composer 直接跳过加载
- 项目
composer.json的repositories写在了子目录里，或格式非法（比如用了单引号、缺逗号）
实操建议：
- 确认本地包根目录已运行
git init && git add . && git commit -m "init" - 本地包的
composer.json中必须含"name": "vendor/name"和"version": "dev-main"（或匹配你require的分支名） - 项目根目录
composer.json的repositories段必须是数组，且每个源带"type": "path"，例如：{ "repositories": [ { "type": "path", "url": "../my-local-package" } ] } - 项目中
require必须写成"vendor/name": "dev-main"，不能写"*"或"^1.0"
想改 vendor 目录位置但怕 autoload 失效
能改，但必须走 config.vendor-dir 这条唯一安全路径。任何手动重命名、移动 vendor 文件夹的操作，都会让 autoload.php 里硬编码的相对路径失效，直接触发 Class not found 或 require(): failed to open stream。
关键点：
-
vendor-dir值只能是相对于项目根目录的路径，如"lib/vendor"，不能以/开头，也不能用../跨出项目根目录 - 改完后必须删掉旧
vendor目录，再执行composer install（dump-autoload不够用） -
autoload.php入口路径会自动适配新位置，但你自己代码里写的require 'vendor/autoload.php'必须手动改成新路径，比如require 'lib/vendor/autoload.php' - 某些框架（如 Laravel 的
public/index.php）或部署脚本里硬编码了vendor/autoload.php，这些地方 Composer 不会帮你改，得人工翻一遍
为什么改了 vendor-dir 后 bin 脚本调用失败
因为 vendor/bin 是 Composer 自动生成的符号链接目录，默认绑定在 vendor 下。你改了 vendor-dir，但没同步配置 bin-dir，导致 phpunit、laravel 这类命令仍试图链接到旧路径。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
解决办法是在 composer.json 的 config 段里一并声明 bin-dir：
{
"config": {
"vendor-dir": "lib/vendor",
"bin-dir": "lib/vendor/bin"
}
}
注意：
-
bin-dir必须是vendor-dir下的子路径，不能独立指定到项目根或其他位置 - 改完需重新运行
composer install，否则旧vendor/bin链接不会被清理，新链接也不会生成 - IDE（如 PHPStorm）可能缓存了旧
bin路径，需要手动刷新 External Libraries 或重新索引
全局镜像配置了还是连不上 packagist.org
不是镜像地址错了，而是 Composer 在 fallback 时仍会尝试访问官方源——如果项目级 composer.json 里没禁用 packagist.org，或 repositories 配置结构不合法，它就会绕过镜像直连。
排查重点：
- 运行
composer config -g repo.packagist，确认返回的是镜像 URL（如https://mirrors.aliyun.com/composer/），不是https://packagist.org - 检查是否误写了
"repo": {"packagist.org": {...}}—— 正确键名是repos.packagist.org（注意repos复数 +.org） - 执行
composer clear-cache，否则旧索引仍在，新镜像不会生效 - 若公司内网有代理或 HTTPS 解密设备，需额外配置证书：用
composer config -g cafile /path/to/company-ca.crt，而不是关secure-http
最易被忽略的是：某些 CI 环境（如 GitHub Actions）默认不读全局配置，必须在 workflow 中显式运行 composer config 设置镜像，否则每次都是裸连。
