讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

C# XDocument Save无BOM UTF-8 解决XML文件带BOM头问题

云强同学_4897

云强同学_4897

发布时间:2026-02-14 09:23:02

|

555人浏览过

|

来源于php中文网

原创

XDocument.Save() 默认带BOM是因为Encoding.UTF8构造函数默认启用BOM;解决方法是使用new UTF8Encoding(false)并调用Save(Stream, Encoding)重载。

c# xdocument save无bom utf-8 解决xml文件带bom头问题

为什么 XDocument.Save() 生成的 XML 文件总带 BOM?

因为 .NET 默认用 Encoding.UTF8(即 new UTF8Encoding())写入,而这个构造函数默认启用 BOM。哪怕你显式传入 Encoding.UTF8,它底层仍是带 BOM 的实例——这不是 bug,是设计行为。

真实场景里,BOM 会导致:Linux 下脚本解析失败、某些 XML 解析器报 Invalid character at position 0、Git 提示文件“看似二进制”、CI 流水线校验不通过。

怎么让 XDocument.Save() 输出无 BOM 的 UTF-8?

必须绕过默认编码,手动指定一个不带 BOM 的 UTF8Encoding 实例,再传给 Save() 的重载版本。

  • 用 new UTF8Encoding(encoderShouldEmitUTF8Identifier: false) 构造编码器
  • 调用 XDocument.Save(Stream, Encoding),而非 Save(string) 或 Save(TextWriter)
  • 别用 File.WriteAllText() 后续覆盖——那会重新引入 BOM

示例:

var doc = new XDocument(new XElement("root", new XElement("item", "test")));
using var fs = File.Create("output.xml");
doc.Save(fs, new UTF8Encoding(encoderShouldEmitUTF8Identifier: false));

XmlWriter 方式更可控但容易漏掉设置

如果要用 XmlWriter(比如需要缩进、禁用空元素折叠等),BOM 控制点在 XmlWriterSettings.Encoding——同样得设成无 BOM 的 UTF8Encoding。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • 忘记设置 settings.Encoding,或误设为 Encoding.UTF8,BOM 照样出现
  • XmlWriter.Create(string) 不接受编码参数,必须用 XmlWriter.Create(Stream, settings)
  • 缩进、换行等格式选项不影响 BOM,但和 BOM 一样,都依赖底层 Stream 写入方式

示例:

var settings = new XmlWriterSettings { 
    Encoding = new UTF8Encoding(false), 
    Indent = true 
};
using var writer = XmlWriter.Create("output.xml", settings);
doc.WriteTo(writer);

注意 FileStream 和 StreamWriter 的陷阱

直接用 StreamWriter 包裹 FileStream 再传给 XDocument.Save(TextWriter) 是常见错误路径——StreamWriter 的 Encoding 构造参数若没设 false,BOM 还是会回来。

  • new StreamWriter(fs, Encoding.UTF8) → 带 BOM(Encoding.UTF8 是静态只读实例)
  • new StreamWriter(fs, new UTF8Encoding(false)) → 正确,但多此一举:不如直接用 Save(Stream, Encoding)
  • File.OpenWrite() 返回的流不支持写入开头(如覆盖),建议用 File.Create() 或 File.Open(..., FileMode.Create)

最简路径就是:Stream + 显式无 BOM 编码器 + XDocument.Save(Stream, Encoding)。

真正麻烦的不是怎么写,而是团队里有人改了某处 File.WriteAllText() 导出逻辑,又忘了配编码——这种散落各处的写法,比统一封装更难排查。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7619

2023.08.02

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

5204

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

6757

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2662

2024.11.28

CSS position定位有几种方式
CSS position定位有几种方式

有4种,分别是静态定位、相对定位、绝对定位和固定定位。更多关于CSS position定位有几种方式的内容,可以访问下面的文章。

352

2023.11.23

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

7679

2023.07.05

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

2100

2023.07.06

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

1254

2023.07.24

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

120

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn