如何阻止Visual Studio在文件转换时添加BOM

转换后文件出现UTF-8 BOM，本质是转换工具默认启用了BOM输出，以下是几种直接有效的解决方式：

1. 自动化脚本修复（适合批量/构建流程） #

PowerShell 一键修正 #

直接读取带BOM的文件并以无BOM UTF-8重新写入：

# 处理Debug转换文件
Get-Content -Path "someconfig.Debug.json" -Encoding UTF8 | Set-Content -Path "someconfig.Debug.json" -Encoding UTF8NoBOM

# 处理Release转换文件
Get-Content -Path "someconfig.Release.json" -Encoding UTF8 | Set-Content -Path "someconfig.Release.json" -Encoding UTF8NoBOM

Python 批量处理脚本 #

适合需要处理大量文件的场景，自动检测并移除BOM：

import os

def ensure_no_bom(file_path):
    with open(file_path, 'rb') as f:
        raw_content = f.read()
    # 检查是否存在UTF-8 BOM头
    if raw_content.startswith(b'\xef\xbb\xbf'):
        cleaned_content = raw_content[3:]
        with open(file_path, 'wb') as f:
            f.write(cleaned_content)
        print(f"已移除{file_path}的BOM")
    else:
        print(f"{file_path}无BOM，无需处理")

# 处理目标转换文件
ensure_no_bom("someconfig.Debug.json")
ensure_no_bom("someconfig.Release.json")

2. 修改转换工具的编码配置（从根源避免BOM） #

如果是用Visual Studio/MSBuild进行配置转换（比如SlowCheetah工具），可以直接在项目文件中强制指定输出编码：
在项目的.csproj或.vbproj文件中添加以下配置：

<PropertyGroup>
  <!-- 强制资源文件使用UTF-8无BOM编码 -->
  <GenerateResourceUseUTF8Encoding>true</GenerateResourceUseUTF8Encoding>
  <!-- 全局文件编码设置 -->
  <FileEncoding>UTF-8</FileEncoding>
</PropertyGroup>

添加后重新执行转换，输出文件会默认使用无BOM的UTF-8编码。

3. 手动工具修正（适合单次处理） #

VS Code操作 #

1. 打开带BOM的转换文件
2. 点击右下角状态栏的编码标识（显示为UTF-8 with BOM）
3. 在弹出的菜单中选择「通过编码保存」->「UTF-8」

Notepad++操作 #

1. 打开目标文件
2. 顶部菜单选择「编码」->「转为UTF-8无BOM编码」
3. 保存文件即可

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