Stylelint 配置加载机制中的缓存问题分析与修复

问题背景

在最近版本的 Stylelint 中，用户报告了一个关于配置加载的严重问题。当项目中存在根目录配置文件时，即使用户通过 API 显式传递了不同的配置对象，Stylelint 仍然会错误地使用根目录配置而忽略用户指定的配置。这一行为严重影响了 Stylelint 作为独立工具使用的可靠性。

问题复现场景

该问题在以下典型场景中出现：

1. 项目根目录存在 .stylelintrc 或类似配置文件
2. 开发者通过 stylelint.lint() API 显式传递配置对象
3. Stylelint 错误地混合了根目录配置和显式配置，导致非预期的校验结果

技术分析

经过深入排查，发现问题核心在于 Stylelint 的配置缓存机制。在 getConfigForFile() 函数中，存在一个不恰当的缓存返回逻辑，导致即使传递了新配置，系统仍可能返回之前缓存的配置结果。

具体表现为：

• 当多次调用 Stylelint 时，后续调用会错误地重用缓存配置
• 显式传递的配置无法正确覆盖已缓存的配置
• 特别是在使用 formatter 时，由于缓存共享导致配置污染

解决方案

开发团队提出了两种临时解决方案：

1. 内联调用方案：将 formatter 的获取改为内联调用，避免共享缓存
2. 延迟加载方案：使用异步函数延迟 formatter 的加载时机

经过深入讨论，团队决定从根本上修复缓存机制问题，而不仅仅是应用临时解决方案。修复方案包括：

• 重构配置缓存逻辑，确保显式配置优先
• 分离不同调用间的配置缓存作用域
• 增加配置加载的隔离性检查

影响与启示

该问题的修复不仅解决了当前报告的 bug，还为 Stylelint 的配置系统带来了以下改进：

1. 配置优先级更明确：显式传递的配置现在能够正确覆盖任何文件系统配置
2. 缓存机制更健壮：避免了不同调用间的配置污染
3. API 行为更可预测：开发者可以更可靠地通过编程方式控制校验行为

最佳实践建议

基于此次修复经验，建议 Stylelint 用户：

1. 当需要完全控制配置时，确保清除或禁用配置缓存
2. 在复杂项目中，考虑显式设置 cwd 参数以避免意外加载根配置
3. 定期更新到最新版本以获取最稳定的配置处理逻辑

此次修复体现了 Stylelint 团队对稳定性和可靠性的承诺，确保了工具在各种使用场景下的一致行为。