在GitHub Actions中使用C# Verify库时如何修复西班牙语特殊字符编码问题

我完全懂你这种本地测试正常、一到GitHub Actions就栽在特殊字符上的挫败感——西班牙语里的í变成?，显然是编码在环境间不匹配导致的。你之前尝试设置ConsoleEncoding=UTF8没效果，是因为这个参数只影响控制台输出，而Verify库的问题出在快照文件的读写编码上，不是控制台层面。

下面给你几个针对性的解决方案，按优先级来：

1. 全局配置Verify使用UTF-8编码 #

这是最直接的办法，让Verify在生成和读取快照时强制用UTF-8编码，彻底解决编码不统一的问题。

在你的测试项目里新建一个类，用ModuleInitializer来全局配置Verify的设置：

using System.Text;
using VerifyXunit;

public static class VerifyConfiguration
{
    [ModuleInitializer]
    public static void SetupVerifyEncoding()
    {
        VerifySettings.RegisterDefaultSettings(settings =>
        {
            // 强制Verify使用UTF-8编码处理快照文件
            settings.UseEncoding(Encoding.UTF8);
        });
    }
}

这个代码会在测试程序启动时自动执行，所有Verify的快照操作都会遵循UTF-8编码，不管是本地还是GitHub Actions环境。

2. 确保GitHub Actions环境的locale是UTF-8 #

有时候Ubuntu runner的默认locale可能不是UTF-8，会影响文件系统的编码处理。你可以在测试步骤前设置正确的locale环境变量：

修改你的GitHub Actions YAML文件，给Test步骤加上环境变量：

- name: Test
  env:
    LC_ALL: en_US.UTF-8
    LANG: en_US.UTF-8
  run: dotnet test --no-build --verbosity normal

如果需要匹配西班牙语环境，也可以设置成es_ES.UTF-8，不过en_US.UTF-8已经能支持所有UTF-8字符的处理了。

3. 重新生成并提交UTF-8编码的快照文件 #

如果你的现有快照文件是用非UTF-8编码生成的，即使配置了上面的设置，旧文件还是会有问题。你需要：

• 在本地运行测试，让Verify重新生成快照文件
• 用编辑器（比如VS Code）打开快照文件，确认右下角显示的编码是UTF-8，如果不是就改成UTF-8并保存
• 把更新后的快照文件提交到GitHub

这样GitHub Actions上读取的就是正确编码的快照了。

为什么之前的ConsoleEncoding设置没用？ #

/p:ConsoleEncoding=UTF8只是让dotnet test的控制台输出用UTF-8，但Verify库是直接读写磁盘上的快照文件，这个参数根本影响不到文件的编码处理，所以自然解决不了问题。

备注：内容来源于stack exchange，提问作者Ricardo Yanez