手动放包进vendor不生效，因composer.lock校验哈希值、autoload未注册、目录结构或composer.json缺失；正确方式是用path repository配合composer require dev-main建立软链与映射。
报错时直接删 vendor 重跑 composer install 多数情况下没用——它只是按 composer.lock 复原，不是重装。
为什么 composer install 报错后手动放包进 vendor/ 不生效
Composer 不认你手动复制的文件，原因很实在：
-
composer.lock里记录了每个包的哈希值，你放进去的目录只要内容不一致（哪怕只少一个空格），后续composer install或dump-autoload都可能跳过 autoload 注册 - 没运行
composer dump-autoload，vendor/autoload.php就不会重新扫描vendor/下的composer.json，类根本加载不了 - 包目录结构不对：必须是
vendor/{vendor-name}/{package-name}/，比如monolog/monolog/，不能是vendor/monolog/monolog-1.2.3/ - 包里缺
composer.json或里面没写"autoload"字段，dump-autoload就找不到要注册的命名空间
手动安装依赖的正确姿势：用 path repository
这是绕过下载、校验、解压全流程的干净方案，适合离线、CI 预置或调试私有包。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 把解压好的完整包（含
composer.json）放到项目内任意路径，例如./packages/my-utils/ - 在项目根目录
composer.json的repositories里加一段：
{
"repositories": [
{
"type": "path",
"url": "./packages/my-utils"
}
],
"require": {
"my-vendor/my-utils": "*"
}
}
- 运行
composer require my-vendor/my-utils:dev-main（注意必须用dev-main，path类型不支持^1.0这类语义版本） - Composer 会软链接该目录到
vendor/，并自动执行 autoload 注册
遇到 ZipArchive::extractTo 错误怎么办
这不是你下错了包，而是 PHP 启用了 zip 扩展，但 Composer 在校验或 fallback 流程中强行调用 ZipArchive 解压 .tar.gz——它不支持 tar 格式，直接崩。
- 先确认：
php -m | grep zip，如果输出zip，问题就在这儿 - 临时禁用 zip 扩展：注释掉
extension=zip（在 CLI 的php.ini里，不是 Web 版本） - 别把
.tar.gz直接丢进vendor/：它会被忽略，或者触发错误；必须解压后再走path方式 - 确保系统有
tar命令可用（Linux/macOS 默认有，Windows 需 Git Bash 或 WSL）
真正麻烦的不是“怎么放进去”，而是“怎么让 Composer 完全信任这个目录”。path repository 是唯一能跳过哈希校验、解压逻辑、远程拉取的路径，其他方式都容易卡在中间某步。别省那一步 composer require，它不只是写 lock，更是建立符号链接和 autoload 映射的关键动作。
