PowerShell模块调用时JSON合并函数行为异常原因排查

问题概述 #

实现了一个PowerShell函数，功能为接收旧JSON文件、新JSON文件、目标文件三个路径，遍历新JSON的叶子节点生成唯一地址列表，按规则合并后保存到目标路径。存在以下异常：

• 以.ps1脚本形式运行：结果正常
• 以.psm1模块形式调用：合并结果出现值末尾追加$、数值被转为带$的字符串的错误
• 环境差异：仅在WSL环境下的Linux版PowerShell中触发，Windows PowerShell运行无问题

可能的根因 #

1. 模块作用域的变量解析冲突：Linux版PowerShell对模块内变量的解析逻辑更严格，若遍历叶子节点时的路径拼接代码未正确转义$符号，会被误解析为PowerShell变量标识，最终混入JSON值中。
2. JSON序列化的平台行为差异：Linux版PowerShell的ConvertTo-Json在处理未显式指定类型的数据时，可能将数值自动转为带$后缀的字符串类型；而.ps1脚本运行时的作用域宽松，序列化逻辑更兼容。
3. 路径处理的跨平台适配问题：WSL环境下路径分隔符为/，若模块中硬编码了Windows风格的路径转义逻辑，可能在生成叶子节点地址时引入额外的$字符。

修复方案 #

1. 修正JSON序列化逻辑 #

在模块的合并保存步骤中，显式指定ConvertTo-Json的参数，强制保留数值类型并避免隐性格式转换：

# 替换原序列化代码
$mergedJson | ConvertTo-Json -Depth 10 -AsArray:$false | Out-File -FilePath $targetPath -Encoding utf8

• -Depth设置为足够覆盖JSON层级的数值（比如10），避免默认深度不足导致的截断或格式异常
• -Encoding utf8确保跨平台编码一致，避免字符解析偏差

2. 转义路径拼接中的$符号 #

若遍历叶子节点时使用字符串拼接生成节点地址，需将$作为普通字符转义（用PowerShell的反引号`）：

# 错误示例：未转义导致$被解析为变量
$nodePath = "$parentPath.$leafNode"
# 修正后：转义$符号
$nodePath = "`$parentPath.`$leafNode"
# 或使用字符串格式化避免解析冲突
$nodePath = "{0}.{1}" -f $parentPath, $leafNode

3. 统一跨平台路径处理 #

使用.NET的[System.IO.Path]类处理文件路径，避免手动拼接分隔符：

# 替换硬编码的路径拼接
$oldJsonContent = Get-Content -Path ([System.IO.Path]::Combine($baseDir, $oldFilePath)) -Raw | ConvertFrom-Json

4. 调试模块运行时状态 #

在模块函数中添加临时调试输出，对比.ps1与.psm1运行时的变量值，定位异常触发阶段：

# 在叶子节点处理逻辑中添加调试
Write-Host "原始值：$($leafValue)，处理后值：$($processedValue)"

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