Yarn执行add/install操作后缓存重复问题求助

1. 检查并修复Yarn配置 #

先查看当前缓存相关配置，确认是否存在路径或源的异常：

yarn config list

重点关注以下配置项：

• cache-folder：确保缓存路径无特殊字符、权限正常
• npmRegistryServer：使用稳定的镜像源（官方源或国内可信镜像）
• strict-ssl：若使用非官方源，可尝试设为false（仅信任该源时操作）

若配置异常，重置为默认值：

yarn config reset

2. 强制重新生成lock文件 #

损坏或冲突的yarn.lock是依赖异常的常见原因，执行以下操作：

• 删除项目根目录下的yarn.lock文件
• 执行强制安装命令，重新解析依赖并生成全新lock文件：

yarn install --force

3. 修复缓存目录问题 #

常规清理缓存无效时，可手动重置缓存目录：

# 清理现有缓存
yarn cache clean
# 临时指定新缓存目录测试安装
yarn install --cache-folder ./temp-yarn-cache

若测试有效，修改默认缓存路径：

yarn config set cache-folder ~/.yarn-cache-stable

4. 排查并解决依赖冲突 #

使用Yarn的依赖分析命令定位重复包：

yarn why <package-name>

若发现多版本冲突，可在package.json中添加resolutions字段强制统一版本：

"resolutions": {
  "存在冲突的包名": "指定统一版本号"
}

添加后执行yarn install生效。

5. 升级Yarn到1.x最新稳定版 #

Yarn 1.22.19存在已知的缓存解析bug，升级到1.x最新版（当前为1.22.22）可修复多数问题：

npm install -g yarn@latest

6. 检查系统权限 #

确保当前用户对项目目录和Yarn缓存目录有读写权限：

• Linux/macOS系统：

chmod -R 755 ./node_modules
chmod -R 755 ~/.cache/yarn

• Windows系统：右键项目目录，进入「属性-安全」，授予当前用户完全控制权限。

内容的提问来源于stack exchange，提问作者Asem Qoraishi