复制web.config文件后出现XML声明异常，排查格式无误求故障原因

错误信息 #

意外的XML声明。XML声明必须是文档中的第一个节点，且其前面不允许出现任何空白字符。

复制web.config文件后出现上述错误，但肉眼检查XML格式并无问题，可能由以下原因导致：

可能的原因 #

• 不可见前置隐藏字符：复制粘贴过程中带入了肉眼识别不了的空白字符（比如全角空格、特殊控制字符），或者文件开头存在BOM（字节顺序标记），这些内容会被XML解析器判定为非法前置内容。
• 编辑器自动插入内容：部分IDE或文本编辑器会在保存时自动往文件开头加注释、版权信息等内容，这些内容藏在XML声明前面，触发报错。
• 文件编码问题：如果文件用UTF-8 with BOM编码，开头的BOM字节（EF BB BF）会被解析成非法字符，肉眼看不到但会被识别。
• 富文本格式残留：从Word、PDF或带格式的网页复制内容时，可能残留格式标记，以不可见形式存在于文件开头。

解决办法 #

• 开启显示所有字符排查：用Notepad或VS Code打开文件，开启「显示所有字符」功能（Notepad：视图→显示符号→显示所有字符；VS Code：通过设置或插件开启），找到开头的隐藏字符并删除。
• 重新保存为无BOM编码：在Notepad++中选「编码→UTF-8 无BOM编码」后保存；VS Code可在右下角编码选项中切换为「UTF-8」并确认移除BOM。
• 手动重写XML声明：删掉现有XML声明，手动输入<?xml version="1.0" encoding="utf-8"?>，确保这是文件第一行，前面没有任何字符。
• 从纯文本源复制：直接从纯文本编辑器里复制web.config内容，避免从带格式的文档或网页复制。

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