GitLab Runner+Docker环境下含法语字符的MSBuild编译编码问题

1. 从GitLab Runner配置层面强制容器编码 #

找到GitLab Runner的config.toml配置文件（通常路径为C:\GitLab-Runner\config.toml），在对应的[[runners]]区块中添加编码相关环境变量，让容器启动阶段就加载UTF-8编码：

[[runners]]
  name = "Windows Docker Runner"
  url = "你的GitLab地址"
  token = "你的Runner令牌"
  executor = "docker"
  environment = ["LC_ALL=en_US.UTF-8", "LANG=en_US.UTF-8", "CODEPAGE=65001"]
  [runners.docker]
    image = "你的自定义buildtools镜像"
    # 其他Docker配置项...

保存配置后重启GitLab Runner服务：gitlab-runner restart

2. 在CI脚本中显式指定编译器编码参数 #

仅修改代码页可能无法覆盖编译器的默认编码逻辑，需给编译命令添加编码强制参数。以.NET项目为例：

build:
  stage: build
  script:
    - chcp 65001
    - dotnet build -p:Utf8Output=true -p:SourceEncoding=utf-8

如果直接使用csc编译器，添加对应编码参数：

csc /utf8output /sourcecharset:utf-8 YourProject.cs

3. 验证CI环境的编码变量 #

在CI脚本开头加入验证命令，确认编码相关环境变量是否生效：

script:
  - echo %CODEPAGE%
  - echo %LANG%
  - echo %LC_ALL%
  # 后续编译命令...

对比本地运行镜像时的输出，确保CI环境下这几个变量与本地一致。

4. 检查代码文件编码格式 #

确认项目中的代码文件为无BOM的UTF-8编码，部分Windows编译器对带BOM的UTF-8文件兼容性较差，可通过VS Code等文本编辑器转换编码格式。

内容的提问来源于stack exchange，提问作者MensSana