解析JSON文件时出错，疑似隐藏值导致本地解析失败

以下是针对这类问题的实用排查和解决步骤：

• 检查隐藏不可见字符
  在线校验工具通常会自动忽略或清理控制字符，但本地解析器对这类字符的兼容性更严格。可以通过两种方式查看：

  • 命令行：Linux/macOS用cat -A yourfile.json，Windows用findstr /n "." yourfile.json，能显示包括BOM、非标准空格、异常换行符在内的所有字符。
  • 文本编辑器：VS Code开启「Render Control Characters」设置，Notepad++开启「视图→显示所有字符」，直观查看文件中的隐藏字符。

• 清理文件内容

  • 移除UTF-8 BOM：如果文件带BOM，Python可以用open("file.json", encoding="utf-8-sig")读取；Node.js可通过fs.readFileSync("file.json", "utf8").replace(/^\uFEFF/, "")移除；Linux/macOS也可使用dos2unix工具转换。
  • 替换非标准空格：将全角空格（\u3000）、不间断空格（\u00A0）替换为标准空格，或直接删除冗余空白字符。
  • 统一换行符：将Windows风格的CRLF转换为Unix风格的LF，避免部分解析器因换行符格式报错。

• 分段定位错误点
  把JSON文件拆分后逐步解析，能快速找到触发错误的片段。比如在Python中可以用json.JSONDecoder.raw_decode方法定位错误位置：

  import json
  with open("file.json", "rb") as f:
      data = f.read()
  decoder = json.JSONDecoder()
  try:
      result, idx = decoder.raw_decode(data)
      print(f"解析成功，剩余起始位置: {idx}")
  except json.JSONDecodeError as e:
      print(f"错误触发位置: {e.pos}")
      print(f"错误附近内容: {data[e.pos-20:e.pos+20].decode('utf-8', errors='replace')}")
  

• 验证文件编码
  确认文件编码为标准UTF-8，部分编辑器可能默认保存为UTF-16或其他编码，导致解析器无法识别。Linux/macOS可通过file --mime-encoding yourfile.json查看编码，VS Code右下角也会显示当前文件编码。

内容的提问来源于stack exchange，提问作者John Balvin Arias