升级至Yarn 3后yarn install --check-files失效，有无等效替代命令？

云上老周

2026-7-2

Yarn 3 中 yarn install --check-files 命令的替代方案

Yarn 3 已经彻底移除了 yarn install --check-files 命令，该命令的功能可以通过以下方式替代：

校验并修复依赖文件完整性：如果怀疑本地 node_modules 文件损坏或与缓存不一致，先清理缓存再重新安装：
```
yarn cache clean
yarn install
```
严格匹配锁文件安装：使用 --immutable 参数强制 Yarn 严格按照锁文件或本地缓存内容安装，若本地依赖存在未记录的修改，命令会直接报错，以此校验依赖一致性：
```
yarn install --immutable
```
自动校验（默认行为）：Yarn 3 的 yarn install 本身会自动校验本地依赖文件与锁文件、缓存的匹配度，若发现缺失或不匹配的文件，会自动同步修复，无需额外参数触发。