Yarn无法通过git+ssh添加私有GitLab依赖，报错缺少_uid

我之前也碰到过类似的Yarn安装私有Git包的问题，这个_uid错误其实是Yarn在处理包元数据时的一个小问题，尤其是针对没有在公共npm registry托管的私有包。下面是几个亲测有效的解决方案：

• 清理Yarn缓存：先执行yarn cache clean，有时候缓存里残留的旧元数据会导致这种奇怪的校验错误，清理完再重新运行安装命令试试。
• 明确指定分支/版本标签：尝试给Git链接加上具体的分支名或版本tag，比如yarn add git+ssh://git@privateserver.org:team/package-name.git#v0.9.2或者yarn add git+ssh://git@privateserver.org:team/package-name.git#main。Yarn有时候对没有明确版本标记的Git包处理逻辑会混乱，指定后能帮它正确识别包的元数据。
• 检查私有包的package.json：确保包内的package.json里name和version字段完全正确，没有缺失或格式错误。npm对这类元数据的容忍度更高，但Yarn的校验逻辑更严格，一点点不规范都可能触发错误。
• 升级Yarn版本：旧版本的Yarn（尤其是早期的Yarn 1.x版本）在处理Git SSH链接的私有包时，确实存在元数据解析的已知问题。升级到最新的稳定版（不管是Yarn 1.x的最终版还是Yarn Berry）大概率能解决这个问题。
• 配置.yarnrc强制解析规则：如果用的是Yarn 1.x，可以在项目根目录的.yarnrc文件里添加一行配置：git+ssh://git@privateserver.org:team/package-name.git "registry:https://registry.yarnpkg.com/"，这能强制Yarn用正确的方式处理这个私有包的源，避免错误地期望它带有registry分配的_uid字段。

至于为什么npm能成功？其实是因为两者对Git包的元数据校验逻辑不一样：_uid是npm registry给每个包分配的唯一标识，但私有Git包并没有这个字段。npm在安装Git包时会跳过对这个字段的校验，而Yarn在某些场景下会错误地要求这个字段存在，这就是问题的根源。

内容的提问来源于stack exchange，提问作者Michael Stanaland