一、Yarn为什么会动我们的node_modules？
很多开发者都遇到过这样的场景：明明昨天还能正常运行的项目，今天突然报错说找不到某个模块。打开node_modules一看，发现里面少了一些文件夹。这种情况往往是因为Yarn"自作主张"删除了部分依赖。
Yarn这么做其实是为了优化存储空间。想象你的衣柜（node_modules）里有很多衣服（依赖包），有些衣服你已经很久没穿了（项目不再使用的依赖），Yarn就像个智能管家，会定期帮你清理这些"闲置物品"。
举个例子：
// 技术栈：Node.js
// 初始安装两个依赖
yarn add lodash moment
// 后来移除了moment
yarn remove moment
// 此时Yarn可能会在下次安装时
// 自动清理node_modules中moment相关的文件
二、Yarn的缓存机制是如何工作的？
Yarn的缓存机制就像个智能仓库，包含三个关键部分：
- 离线镜像（.yarn/cache）：存储所有下载过的包
- 项目缓存（node_modules）：当前项目实际使用的依赖
- 全局缓存（用户目录下的.yarn目录）：跨项目共享的依赖
当执行yarn install时，Yarn会按照这个优先级查找依赖：
- 先看node_modules里有没有
- 没有就去项目缓存找
- 还没有就去全局缓存找
- 最后才去网络下载
这里有个实际例子：
# 技术栈：Node.js
# 查看Yarn缓存列表
yarn cache list
# 清理缓存
yarn cache clean
# 强制重新构建node_modules
yarn install --force
三、什么情况下Yarn会删除node_modules？
主要有三种情况会让Yarn对node_modules"动手"：
- 依赖关系发生变化时：
// 技术栈：Node.js
// 情况1：package.json中版本号变更
"dependencies": {
"react": "^17.0.0" → "react": "^18.0.0"
}
// 情况2：添加/删除依赖
yarn add vue
yarn remove jquery
- 执行特定命令时：
# 技术栈：Node.js
# 这个命令会重新构建依赖树
yarn install --check-files
# 这个命令会强制重新安装
yarn install --force
- 缓存策略触发时： Yarn会根据缓存策略自动清理未被引用的包，类似于"垃圾回收"机制。
四、如何避免Yarn误删重要依赖？
这里有五个实用建议：
- 使用
resolutions字段锁定关键依赖版本：
// 技术栈：Node.js
{
"resolutions": {
"react": "17.0.2",
"react-dom": "17.0.2"
}
}
- 善用
.yarnrc配置文件：
# 技术栈：Node.js
# 禁用自动清理
disableSelfUpdate true
# 设置缓存保留时间
cache-folder /path/to/cache
cache-lifetime 30d
- 重要项目使用
yarn.lock锁定版本：
# 技术栈：Node.js
# 生成精确版本锁定文件
yarn install --frozen-lockfile
- 定期备份node_modules：
# 技术栈：Node.js
# 创建压缩备份
tar -czvf node_modules_backup.tar.gz node_modules
- 使用
--ignore-scripts防止安装脚本意外删除：
yarn install --ignore-scripts
五、Yarn缓存机制的优缺点
优点：
- 节省磁盘空间：避免重复下载相同版本的包
- 加快安装速度：优先使用本地缓存
- 离线可用：曾经下载过的包可以离线安装
- 版本控制稳定：通过yarn.lock确保一致性
缺点：
- 可能误删依赖：自动清理有时会过度积极
- 缓存占用空间：长期积累会占用较多磁盘
- 调试困难：缓存问题有时难以追踪
- 需要手动维护：偶尔需要清理过期缓存
六、最佳实践指南
- 大型项目推荐配置：
# .yarnrc.yml
nodeLinker: node-modules
enableGlobalCache: true
checksumBehavior: throw
- 关键依赖保护方案：
# 技术栈：Node.js
# 将关键依赖加入optionalDependencies
yarn add react --optional
- 自动化清理策略：
# 每月清理一次旧缓存
0 0 1 * * yarn cache clean --age 86400
- 依赖完整性检查脚本：
// 技术栈：Node.js
const fs = require('fs');
const required = ['react', 'react-dom'];
required.forEach(pkg => {
try {
require.resolve(pkg);
} catch (e) {
console.error(`关键依赖缺失: ${pkg}`);
process.exit(1);
}
});
七、常见问题解决方案
问题1：突然报错"Module not found" 解决方案：
# 重新生成node_modules
rm -rf node_modules
yarn install --check-files
问题2：Yarn占用了太多磁盘空间 解决方案：
# 查看缓存占用
yarn cache list --pattern ""
# 清理旧缓存
yarn cache clean --all
问题3：团队协作时依赖不一致 解决方案：
# 强制使用yarn.lock
yarn install --frozen-lockfile
# 或者
yarn policies set-version latest
问题4：某些依赖被重复安装 解决方案：
# 分析依赖树
yarn why lodash
# 使用dedupe优化
yarn dedupe
八、总结与建议
Yarn的缓存机制设计初衷是好的，但在实际使用中确实可能带来一些"惊喜"。理解它的工作原理后，我们可以更好地驾驭它而不是被它困扰。
对于不同规模的项目，我有这些建议：
- 小型项目：可以放心使用默认配置
- 中型项目：建议配置.yarnrc优化缓存策略
- 大型项目：应该建立完整的依赖管理规范
记住，任何工具都是双刃剑。Yarn的缓存机制在提升效率的同时，也需要我们适当了解和管控。希望本文能帮助你更好地理解和使用Yarn，让你的项目依赖管理更加得心应手。
Comments