您运行 yarn install, and the dependency you just updated still resolves to the old build. Or your laptop installs fine while CI suddenly fails after a harmless lockfile change. Or Docker rebuilds drag on, even though you’re “using cache.”
通常人们会在这个时候搜索 清除 Yarn 缓存 粘贴他们找到的第一个命令。
Sometimes that works. Sometimes it fixes nothing. The reason is simple: Yarn’s cache behavior depends heavily on which Yarn you’re running, and the difference between Yarn Classic v1 and context: Page/area: Capgo marketing website. Role: Short UI label or navigation item. Seen in: page trust.astro. Message key `and` (And). Yarn Berry v2+
is big enough to change both the right command and the right troubleshooting strategy. yarn cache clean。只是刚刚开始。关键是缓存范围，项目是否使用本地缓存还是共享缓存，以及缓存是否是真正的问题。CI和Docker中，缓存策略不当往往比陈旧的包存档带来更多痛苦。
目录
- 你的构建出现问题，Yarn 缓存可能是原因
- 何时何地清除 Yarn 缓存
- 清除 Yarn Classic v1 缓存
- Yarn Berry v2+ 中的现代缓存管理
- CI/CD和Docker的Yarn缓存最佳实践
- 解决常见的Yarn缓存错误
- 关于清除Yarn缓存的常见问题
你的构建出错了，Yarn缓存可能是原因
一个熟悉的模式看起来像这样。您更新一个包，pull最新的更改，然后再次运行安装命令。命令完成，但应用程序仍然表现得像旧依赖项存在一样。然后有人建议清除缓存，现在您正在思考是否这是一个真正的解决方案还是只是迷信。
它可能是一个真正的解决方案。它也可能是一个分散的注意力。
缓存问题通常以几个可预测的方式出现。一个本地包不会刷新。CI pull一些意外的内容。一个新分支的行为与主分支不同，尽管锁文件说应该匹配。如果您已经在追踪更广泛的管道不稳定性，帮助您将缓存调试与更系统的构建审查结合起来，例如本指南中的 修复Capacitor CI/CD管道中的构建故障.
实用规则： 将Yarn清除缓存视为诊断工具，而不是维护仪式。
困难的部分是Yarn在时间上改变了其缓存模型。在旧项目中，缓存是共享的。 在新项目中，缓存清理可以是本地的、全局的或两者兼而有之，取决于命令标志。因此，当同事说“只需清除Yarn缓存”，第一个问题应该是： 哪个Yarn？
因此，一个好的缓存修复始于上下文。 本地机器或CI运行器。 Yarn v1或Berry。 共享缓存或项目缓存。 一旦您知道了这一点，命令就变得精确而不是盲目。
何时何时清除Yarn缓存
当你有特定的故障模式时，清除Yarn缓存是有意义的。它最有用的是当你需要移除陈旧的包裹文件、恢复从断点下载状态、或故意清除存储的包裹使Yarn重新构建从头开始。
指向缓存问题的症状
有些情况是强烈的缓存候选者：
- 依赖项拒绝更新： 你改变了版本，或者重建了一个本地包，但安装仍然拉取一个旧的包裹。
- 安装失败，感觉像状态相关： 一个机器正常，另一个不正常，重新运行相同的命令仍然重现相同的错误结果。
- 你需要回收本地磁盘空间： 这在开发者机器上比在短暂的CI环境中更为重要。
其他情况看起来像缓存问题，但实际上并不是。 如果你的锁文件突然改变了，或者工作区设置不一致，或者Docker构建错误地invalidate了一个层，清除缓存并不能解决根本问题。 团队在处理app构建时经常遇到这个问题，需要在native工具、JavaScript依赖项和插件更新之间进行平衡。在这种情况下，这个实用的概述是关于 管理Capacitor项目的依赖项 值得保留在附近。
如果您的目标是更广泛的机器清理，而不是包裹故障排除，系统级别的指南也可以提供帮助。想要清理 Mac 的开发者可以 清除 Mac 应用程序缓存 Mac 开发者经常发现，包管理器只是存储问题的一部分。
何时不应该清除 Yarn 缓存
不要将 Yarn 清除缓存作为每个安装问题的第一反应。
使用它时，应有证据表明存在陈旧或损坏的包状态。跳过它，当问题更可能是：
| 情况 | 更好的第一步 |
|---|---|
| 锁文件漂移 | Review yarn.lock 更改和重新安装一致 |
| 工作区解析问题 | 检查工作区配置和安装行为 |
| Docker重建缓慢 | 查看层次顺序和缓存持久性 |
| CI不匹配 | 验证实际恢复的目录 |
如果安装错误是因为环境错误，清除缓存只会使下一次错误安装更慢。
这项区分节省了时间。大量的调试浪费来自对缓存的误解，认为它是一种魔法重置按钮。
清除Yarn Classic v1中的缓存
Yarn Classic遵循许多开发人员仍然假设所有Yarn版本都遵循的方式。它使用 全局缓存 在用户目录中 yarn cache clean 清除共享缓存。 Yarn Classic 的文档描述了它的方式，并指出缓存在下一次重载时会被重新填充。 yarn 或 yarn install 在用户目录中使用的模式，详见文档 the Yarn Classic cache CLI docs.
实际上命令删除的是什么
清除缓存后，Yarn Classic 的缓存将被清除。 Yarn Classic 的文档描述了它的方式，并指出缓存在下一次重载时会被重新填充。
yarn cache clean
清除缓存后，Yarn Classic 的缓存将被清除。 Yarn Classic 的文档描述了它的方式，并指出缓存在下一次重载时会被重新填充。
清除缓存后，Yarn Classic 的缓存将被清除。 Yarn Classic 的文档描述了它的方式，并指出缓存在下一次重载时会被重新填充。
清除缓存后，Yarn Classic 的缓存将被清除。 Yarn Classic 的文档描述了它的方式，并指出缓存在下一次重载时会被重新填充。
- 清除缓存后，Yarn Classic 的缓存将被清除。 Yarn Classic 的文档描述了它的方式，并指出缓存在下一次重载时会被重新填充。
yarn cache clean - 如果需要，请清除本地安装文件。
node_modules通常情况下，当状态仍然看起来不一致时，重新安装是下一个候选项。 - 重新安装从头开始： 重新运行
yarn install当您想要检查或删除缓存目录时，Yarn Classic 会给出路径：
这在命令__CAPGO_KEEP_0__看起来似乎无法解决问题时很有用，或者在您需要确认在共享或容器化环境中缓存目录的用户帐户时很有用。
如果您正在使用较旧的工具链并且试图保持本地设置可预测，这个关于
yarn cache dir
安装CLI __CAPGO_KEEP_1__的逐步指南
与清洁依赖项重置配对起来效果很好。 安装Capacitor CLI 对于v1项目，思维模型很简单。一个共享缓存，一个广泛的清除命令，下一个安装重新填充您删除的内容。
重新安装从头开始：
重新运行
现代缓存管理在Yarn Berry v2+中
Yarn Berry改变了对话。如果您习惯于使用Yarn v1，最大调整是缓存清除不再仅仅是“清空全局存储并尝试再次”。Berry支持更精确的控制，这对于您了解目标后是有用的。
Berry改变了缓存模型
在现代Yarn中，缓存行为与项目本身更密切相关。这符合Berry更广泛的项目级控制、插件式和工作流程的方法，其中依赖项可以与仓库一起存活，而不是在单个机器级缓存模型中。
这就是为什么老的建议会误导您的原因。团队成员如果在v1上学习了Yarn，可能会期望一个命令来清除全球的所有内容。在Berry中，您需要以项目范围为单位思考。 范围.
如果您处理不同于移动和Web管道的构建输出，那么同样的范围思维在包管理之外也适用。这比较了 构建类型 的有用提示，提醒您环境假设会渗透到调试中。
以下是一个快速可视化解释，之后是命令详细信息：
Berry中的关键命令
现代 Yarn 文档 yarn cache clean 作为移除 共享缓存文件,并且暴露了两个重要 switch 在 当前 Yarn 缓存清理命令参考:
yarn cache clean移除 Yarn 的共享缓存文件。yarn cache clean --mirror清除全局缓存而不是本地项目缓存。yarn cache clean --all清除全局缓存文件和当前项目的本地缓存文件。
这给了你一个比 Yarn v1 更有意图的工作流程。
| 目标 | 命令 |
|---|---|
| 清除默认共享缓存范围 | yarn cache clean |
| 清除全局镜像缓存 | yarn cache clean --mirror |
| 全局和本地缓存文件进行全面重置 | yarn cache clean --all |
使用 --all 当您希望完全重启时使用 --mirror 当您知道问题出现在全局缓存层并且不想清除整个项目时使用
决策点： 在Berry中，选择错误的范围是清除缓存似乎“无效”的主要原因之一。
Yarn缓存最佳实践：CI/CD和Docker
Yarn 缓存最佳实践（CI/CD 和 Docker）
更有用的问题是：
您缓存的是什么，恢复的是什么？ 使用__CAPGO_KEEP_0__时
为什么在管道中清除缓存往往是错误的选择
一个CircleCI讨论捕捉到了许多团队在实际项目中遇到的失败模式。缓慢的安装并没有通过清除缓存来解决，因为瓶颈并不是陈旧的包存档，而是fetch和link行为、缓存目录不匹配以及缓存集中的缺失路径，正如在那篇 node_modules CircleCI Yarn缓存文章中描述的那样 这很重要，因为CI系统往往会将潜在原因隐藏在一个模糊的症状后面：“安装慢”或“依赖步骤不稳定”。开发人员然后清除缓存，重新运行，但没有获得任何有意义的改进。.
常见的管道错误包括：
缓存错误的目录：
- 恢复步骤完成，但Yarn并没有使用恢复的位置。 忽略工作区路径：
- 根依赖项可能会恢复，而工作区安装工作仍然需要重新链接。 在Docker层中构建顺序不正确：
- __CAPGO_KEEP_0__ A code 源文件使依赖层失效，因此每次安装包都会重新运行。
在 CI 中，由于配置不当导致的缓存失效看起来与缓存损坏的缓存非常相似。
如果您在自动化环境中构建移动应用程序，这也就是发布工具进入的场景。团队经常将 GitHub Actions 或 CircleCI 与发布和更新系统结合起来。其中一个选项是在更广泛的工作流中使用 Capgo’s CI/CD setup for Capacitor apps用于 __CAPGO_KEEP_1__ 应用程序
，并与您的包管理器和构建缓存策略一起使用。
更好的 CI 和 Docker 方法
有意地使用缓存失效，而不是情绪化地使用。
- 对于 CI，一个可靠的模式如下： 基于依赖状态的缓存：
yarn.lock将缓存键绑定到 - 和相关的 Yarn 配置文件上。 确保恢复的路径与Yarn在该环境中使用的路径匹配。
- 安装一致: 在不可变的设置中，使用强制锁文件正确性的安装模式。
- 在真实变化时失效: Yarn版本更改、锁文件更新或缓存路径更改是重建缓存的好理由。
对于Docker，原则是类似的:
- 首先复制依赖项清单: 尽可能将依赖项安装层与应用程序源分开。
- 避免在镜像构建中不必要的清理: 在同一构建中删除缓存通常会移除有用的层重用。
- 明确用户所有权: 由root创建的缓存目录可能会在非root运行时用户安装时导致失败。
一个简短的决策表格有助于：
| 场景 | 比之前更好的行动 yarn cache clean |
|---|---|
| CI 安装缓慢后恢复 | 验证缓存路径和恢复顺序 |
| 工作区仍然频繁重链接 | 缓存相关工作区安装的艺术品 |
| docker 重建重新安装 | 依赖文件重新排列层级 |
| 重新排列依赖文件的层次 | 依赖项变化后出现一次坏的构建 |
清除缓存键，然后重新构建干净地进行一次试验。
解决常见的Yarn缓存错误
最令人沮丧的缓存错误是那些能够抵抗缓存清除的错误。您运行一个目标清洁、重新安装，并且Yarn仍然从旧包中拉取。到那时，它很容易假设注册表是错误的或锁文件是被诅咒的。
一个在Yarn中记录的历史问题解释了为什么会发生这种情况。开发人员报告说 yarn cache clean <package-name> 可能会留下一个旧副本在 cache/.tmp中，这意味着安装一直使用过时的版本，直到临时目录被删除或进行了全面的清洁，正如在 中讨论的Yarn问题中关于 .tmp.
缓存中陈旧的艺术品
当一个目标清洁仍然留下陈旧的包裹后 这个教训很简单。
部分清洁并不总是足够的。
- 如果您怀疑版本陈旧而不是广泛的腐败，使用以下顺序: 首先进行明显的检查：
- 不要完全信任包管理器自带的清理功能: 针对性的清理可能会留下临时文件。
- 升级到全局缓存清除: 如果旧版本仍然存在，清理更广泛的缓存范围。
- 手动检查临时缓存路径: 在旧的设置中，
cache/.tmp可能是缺失的关键部分。
当一个包始终解析到旧的工件时，临时缓存文件通常是我的第一步检查目标，尤其是在目标清理失败后。
权限和环境问题可能会表现为缓存问题
并不是每个“缓存错误”都是缓存内容问题。
在Docker、多用户Linux系统或CI运行器中，可能会遇到权限失败，因为缓存目录的所有者与运行Yarn的进程用户不同。在这种情况下，清除缓存不会解决问题，直到所有权问题得到解决。实践方法是以正确用户身份运行Yarn，或者在重新安装之前修复目录所有权。
这种类型的问题通常会表现为缓存过期，因为安装在不同环境中不一致。解决方案是操作性的，而不是与包相关的。
关于清除Yarn缓存的常见问题
清除Yarn缓存是否安全
是的。在正常开发中，这是一个安全的操作，因为您正在删除缓存的包裹文件，而不是删除应用程序源代码。Yarn可以在下一次安装时重新获取所需的文件。
清除缓存的代价是时间。清除缓存意味着下一次安装可能需要下载或重建更多内容。
应该多久清除一次
只有当有原因时才需要。
Yarn清除缓存不应成为健康项目的常规维护。将其放入每个工作流程中会习惯性地减慢本地安装速度并破坏CI缓存。使用它时，依赖项过时、安装看起来有问题，或者您需要故意重置调试时。
会影响生产构建吗
不会直接影响。清除本地或CI缓存不会改变您提交的应用程序code。
它改变的是准备构建的环境。如果您的生产管道依赖于缓存的安装文件，清除它们可能会使构建速度变慢或暴露隐藏的可重复性问题。这种情况在调试时有用，但不应在发布脚本中随意添加。
什么是最简单的实践规则
使用最小的清理来匹配问题
对于本地调试，使用 Yarn 在该项目中使用的缓存范围开始。对于 CI 和 Docker，修复缓存设计之前不要开始清除缓存。并且，当一个包专用清除不起作用时，假设临时文件或环境不匹配之前不要假设 Yarn 是破损的。
If 你的团队发布 Capacitor 应用并需要一个更干净的依赖或构建问题后发布管道 Capgo 是将 JavaScript 和资产更新交付到商店而不必等待商店审查，同时保持你的构建和发布过程与包缓存调试过程分开的选项。
