PowerShell中ConvertFrom-Json处理JSON文件时的换行符问题解析

问题背景

在使用PowerShell处理JSON文件时，开发人员可能会遇到一个看似奇怪的现象：当JSON文件包含非标准换行符时，ConvertFrom-Json命令会解析失败。这个问题在Windows环境下尤为常见，因为Windows系统默认使用CRLF（\r\n）作为换行符，而其他系统通常使用LF（\n）。

问题重现

当JSON文件包含混合换行符时，直接使用ConvertFrom-Json命令会报错。例如，一个JSON文件可能大部分行使用LF换行，但最后一行使用CRLF换行。这种情况下，直接运行以下命令会失败：

ConvertFrom-Json .\test.json

错误信息会提示："Unexpected character encountered while parsing number: . Path '', line 1, position 1."

问题本质

深入分析后发现，这实际上不是ConvertFrom-Json命令本身的bug，而是使用方式的问题。ConvertFrom-Json命令设计上并不直接支持文件路径作为输入参数，它期望接收的是一个字符串。当直接传递文件路径时，PowerShell会尝试将文件路径作为字符串解析，而不是读取文件内容。

解决方案

有三种可行的解决方法：

1. 使用Get-Content读取文件内容并转换为字符串：

ConvertFrom-Json ((Get-Content .\Test.json) | Out-String)

2. 统一换行符格式：

(Get-Content .\Test.json).ReplaceLineEndings() | ConvertFrom-Json

3. 使用Get-Content的-Raw参数（推荐）：

Get-Content .\Test.json -Raw | ConvertFrom-Json

最佳实践建议

1. 在处理JSON文件时，始终明确读取文件内容后再进行转换
2. 推荐使用Get-Content的-Raw参数，它能高效地读取整个文件内容作为单个字符串
3. 对于跨平台项目，考虑在保存JSON文件时统一使用LF换行符
4. 在团队协作环境中，建议在.gitattributes文件中设置统一的换行符处理规则

技术原理

Windows和Unix-like系统在换行符处理上的差异是导致这类问题的根本原因。PowerShell的ConvertFrom-Json命令在解析时对输入字符串的格式有严格要求。当直接传递文件路径时，PowerShell会尝试将路径字符串解析为JSON，而不是读取文件内容，这导致了意外的解析错误。

理解这一机制后，开发人员就能更好地处理JSON文件解析问题，避免在跨平台开发中遇到类似的陷阱。