xUnit测试框架中字符串断言对空白字符处理的文档更新

在xUnit测试框架中，字符串比较断言方法Assert.Equal提供了对空白字符处理的灵活性。最新版本对相关文档进行了重要更新，以更清晰地说明其行为特性。

空白字符处理机制

xUnit框架为字符串比较提供了两个关键参数来控制空白字符的处理方式：

1. ignoreWhiteSpaceDifferences参数
2. ignoreAllWhiteSpace参数

这些参数主要影响水平空白字符（如空格和制表符）的处理，而不会影响垂直空白字符（如回车符和换行符）的比较。

参数行为详解

ignoreWhiteSpaceDifferences参数

当设置为true时，此参数会忽略字符串中水平空白字符的数量差异。例如，连续多个空格会被视为与单个空格等效。

ignoreAllWhiteSpace参数

此参数更为严格，设置为true时会完全忽略所有水平空白字符。字符串比较时将不考虑任何空格或制表符的存在。

垂直空白字符的特殊性

需要注意的是，上述参数仅适用于水平空白字符。垂直空白字符（如换行符\n和回车符\r）总是会被纳入比较考虑范围，不受这两个参数的影响。

实际应用场景

这种区分设计使得测试可以：

• 灵活处理代码格式化带来的空格差异
• 同时严格检查文本结构中的换行位置
• 在需要时保持对垂直布局的精确验证

版本更新情况

这一文档说明已在以下版本中更新：

• v2系列：2.6.7-pre.10版本
• v3系列：0.1.1-pre.360版本

开发者在编写字符串比较测试时，应当注意这些参数的实际作用范围，以确保测试行为符合预期。特别是在处理格式化文本或多行字符串时，理解水平与垂直空白字符的区别尤为重要。