Azure DevOps为何显示编码从UTF-8变为Windows-1252？

一、让.editorconfig配置真正生效 #

你的.editorconfig配置过于简略，容易被上级配置覆盖或不生效，直接替换成下面的配置：

root = true  # 标记为根配置，避免上级目录的.editorconfig干扰

[*.cs]
charset = utf-8
end_of_line = crlf  # 可选，统一换行符能减少编码相关的隐性问题

同时在Visual Studio中启用.editorconfig支持：打开「工具」→「选项」→「文本编辑器」→「常规」，勾选「根据.editorconfig设置自动检测编码」（不同VS版本位置略有差异，找不到可直接搜索.editorconfig）

二、从源头阻止编码变更 #

• 给VS设置全局默认编码：「工具」→「选项」→「文本编辑器」→「所有语言」→「文件」，将「默认编码」改为UTF-8（选带签名或无签名看项目需求，一般推荐无签名避免BOM坑）
• 安装Visual Studio扩展如Encoding Checker，保存文件时自动检测编码，若误存为Windows-1252会自动修正
• 添加Git预提交钩子，提交前自动检测编码，不符合UTF-8则阻止提交：
  新建.git/hooks/pre-commit文件，粘贴以下脚本（记得给文件添加执行权限）：

#!/bin/bash
for file in $(git diff --cached --name-only | grep '\.cs$'); do
  encoding=$(file -b --mime-encoding "$file")
  if [ "$encoding" != "utf-8" ] && [ "$encoding" != "utf-8-with-bom" ]; then
    echo "错误：文件 $file 编码是 $encoding，必须使用UTF-8"
    exit 1
  fi
done
exit 0

• 在Azure DevOps构建管道中添加检测任务，用PowerShell脚本扫描所有.cs文件，编码不符合要求则标记构建失败：

$csFiles = Get-ChildItem -Recurse -Filter *.cs
foreach ($file in $csFiles) {
  # 读取文件前几个字节判断编码
  $bytes = Get-Content $file -Encoding Byte -ReadCount 4
  $encoding = if ($bytes[0] -eq 0xEF -and $bytes[1] -eq 0xBB -and $bytes[2] -eq 0xBF) {
    [System.Text.Encoding]::UTF8
  } else {
    try {
      [System.Text.Encoding]::UTF8.GetString($bytes) | Out-Null
      [System.Text.Encoding]::UTF8
    } catch {
      [System.Text.Encoding]::GetEncoding(1252)
    }
  }
  if ($encoding.WebName -ne 'utf-8') {
    Write-Error "文件 $($file.FullName) 编码为 $($encoding.WebName)，不符合UTF-8要求"
    exit 1
  }
}

三、这是Bug吗？ #

大概率不是Visual Studio或Azure DevOps的Bug，主要由以下场景导致：

• 少数用户的VS默认编码设置为Windows-1252，打开文件时自动转码并保存
• 部分文件本身编码标记不明确（如无BOM），被VS误识别为Windows-1252
• .editorconfig未放在仓库根目录，或VS未启用.editorconfig支持，导致配置未加载
• 第三方工具、脚本修改文件时意外改变了编码

四、错误编码检测方法 #

• 手动检测：打开文件后查看VS右下角的编码标识，若显示Windows-1252，直接切换为UTF-8
• 批量检测：用PowerShell或file命令批量扫描仓库内的.cs文件编码
• PR自动检测：在Azure DevOps中添加PR验证任务，创建PR时自动检测编码，不符合要求则阻止合并

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