Rustfmt项目中RUSTC_BLESS环境变量行为异常分析

在Rustfmt项目的测试过程中，开发者发现当使用RUSTC_BLESS=1 cargo test命令时，系统会意外修改源文件而非目标文件。这一行为与预期不符，引发了关于测试工具正确工作方式的讨论。

问题现象

当开发者在测试环境中执行以下操作序列时：

1. 手动修改目标文件内容
2. 启用RUSTC_BLESS环境变量运行测试
3. 检查文件变更

结果显示系统不仅修改了目标文件，还意外改动了源文件内容。具体表现为：

• 源文件中的use语句被合并
• 目标文件内容被清空并重新写入

技术背景

RUSTC_BLESS是Rust生态中常见的测试辅助工具，通常用于自动化更新测试期望值。其标准工作流程应该是：

1. 运行测试并生成实际输出
2. 将实际输出与预期输出对比
3. 当测试失败且BLESS模式启用时，用实际输出覆盖预期输出

在Rustfmt的上下文中，这应该意味着：

• 源文件作为输入保持不变
• 目标文件作为预期输出被更新

问题根源

经过分析，这一异常行为源于最初实现时的特殊考虑：

1. 该功能最初为rust-lang/rust仓库的./x支持而开发
2. 在自测试场景下需要修改源文件以实现"dogfooding"（自举测试）
3. 当源文件和目标文件相同时，修改源文件是必要行为

解决方案

根据项目维护者的讨论，正确的行为应该是：

1. 在常规测试场景下，只更新目标文件
2. 仅在自测试/特殊场景下才考虑修改源文件
3. 需要明确区分这两种工作模式

最佳实践建议

对于Rustfmt项目的使用者，建议：

1. 了解RUSTC_BLESS在不同上下文中的行为差异
2. 在常规开发中，预期它只会更新目标文件
3. 进行自测试时，注意它可能会修改源文件
4. 重要变更前做好版本控制，避免意外修改

这一问题的解决将提高测试工具的可靠性和可预测性，使开发者能够更安全地使用BLESS模式来更新测试期望值。