Visual Studio2017设置默认编码为UTF-8不带BOM

在 Windows 环境下使用 Visual Studio 2017 开发 C# 项目时，团队通常希望源文件采用不带 BOM 的 UTF-8 编码，以防某些工具误将文件头标记识别为正文内容。鉴于 VS 2017 并未提供后续版本中常见的“所有文件默认编码”全局选项，最佳实践是通过项目内的 EditorConfig 文件确立编码规范，并对已有文件逐一进行转换与验证。下文将以解决方案目录中的 HelloApp 项目及 Program.cs 文件为例展开说明。

1. 在项目目录设置编码约定

1. 首先在 Visual Studio 2017 中打开目标解决方案，并定位到项目所在文件夹。建议确认当前安装的 VS 2017 版本已支持 EditorConfig 功能；由于不同更新版本对编码选项的支持程度可能存在差异，推荐升级至该系列的最新稳定版并进行实际测试。
2. 在项目根目录下创建一个名为 .editorconfig 的纯文本文件。请注意，该文件名以点号开头，且不应包含额外的 .txt 扩展名。若目录下已存在同名文件，应将新配置合并其中，避免覆盖既有的规则设置。
3. 在文件中写入以下内容并保存：

root = true

[*.cs]
charset = utf-8

其中，[*.cs] 用于将规则限定于当前目录及其子目录下匹配的 C# 文件；charset = utf-8 指定编码格式为 UTF-8 且不带 BOM。root = true 的作用是停止向上层目录查找其他 EditorConfig 文件，因此若团队依赖上层目录的规则，需审慎决定是否保留此行。此外，子目录中更贴近文件的配置可能会覆盖此项设置。

项目中的 EditorConfig 编码配置示意

重新加载项目文件后，新建或编辑一个 C# 文件并保存，随后按后续步骤检查文件字节。需注意，此配置仅作为项目范围内的约定，并非适用于 Visual Studio 所有文件类型的全局开关，不同扩展名的文件行为可能各异。早期版本的 VS 2017 曾出现过与 charset 相关的兼容性问题，若验证结果不符合预期，请检查软件版本、其他 EditorConfig 规则及相关扩展插件。

2. 将已有文件另存为无 BOM 编码

EditorConfig 仅在创建配置时定义规则，不会自动批量重写磁盘上的旧文件。对于已存在的 Program.cs，首先应在编辑器中确认中文内容显示正常；若打开时出现乱码，需先以正确的原始编码重新打开文件，否则直接另存为会将乱码固化。建议在操作前通过版本控制系统备份原文件，以便对比和恢复。

1. 打开 Program.cs 文件，点击“文件”菜单中的“另存为”选项。在弹出的保存对话框中，展开“保存”按钮旁边的下拉菜单，选择“保存时编码”选项；具体菜单文字可能因界面语言设置而略有不同。
2. 在编码列表中选择 Unicode (UTF-8 无签名) - 代码页 65001 或含义相同的“UTF-8 无签名”选项，确认保存。在覆盖原文件之前，请务必核对文件路径和文件名是否正确。
3. 关闭并重新打开该文件，确认中文内容依然显示正常。若需处理多个既有文件，须对每个文件重复上述检查步骤；切勿误以为新增的配置规则会自动完成所有旧文件的编码转换。

选择 UTF-8 无签名编码保存文件示意

此处“无签名”意指文件开头不写入 UTF-8 的 BOM（字节顺序标记），但文件内容本身仍遵循 UTF-8 编码标准。仅凭编辑器中中文显示正常不足以判断是否去除了 BOM，因为带 BOM 和不带 BOM 的 UTF-8 文件通常均能正确渲染文本。

3. 检查文件开头的字节

在 Windows PowerShell 中切换至 Program.cs 所在目录，执行以下命令：

Format-Hex -Path .\Program.cs

观察输出结果中偏移量为 00000000 的首行，从最左侧字节开始检查。若前三个字节为 EF BB BF，表明文件带有 UTF-8 BOM；若开头并非这三个字节，则说明没有 UTF-8 BOM。例如，一个仅包含汉字“中”的 UTF-8 文件，在无 BOM 情况下其字符字节为 E4 B8 AD；若带 BOM，则会先出现 EF BB BF，随后才是字符字节。需要注意的是，实际 C# 文件通常以代码或空白字符起始，不一定呈现此示例中的特定字符字节。

UTF-8 文件带 BOM 与不带 BOM 的字节示意

未发现 EF BB BF 仅证明文件不包含 UTF-8 BOM，不能据此单一特征断定文件必为 UTF-8 编码。还需结合保存时选择的编码选项、重新打开后的中文显示效果以及项目工具链的验证结果综合判断。若结果不符，请检查是否误选了带签名的 UTF-8、是否存在更近层级的 .editorconfig 规则覆盖，并对目标文件重新保存后再次复查。