PowerShell 5.1 哈希表键值是否存在长度限制及替代存储方案？

PowerShell哈希表长度限制问题解答 #

核心结论 #

PowerShell 自带的哈希表类型不存在值长度限制，只要系统内存充足，可存储任意长度的字符串值。你遇到的内容截断问题和哈希表本身无关，是 ConvertTo-Json cmdlet 在PowerShell 5.1版本的默认行为导致的。

你可以先运行以下代码验证哈希表存储的内容是否完整：

# 输出哈希表中对应值的字符长度，和原始值长度对比即可确认存储是否正常
$inputFileJson[$config.NAME].Length

现有代码修复方案 #

PowerShell 5.1 中 ConvertTo-Json 默认限制了JSON输出的最大长度，只需要新增 -MaxJsonLength 参数指定足够的上限即可解决截断问题，修改后的参考代码如下：

$inputFileJson = @{}
$inputFileJson.Add($config.NAME, $config.VALUE)
# -MaxJsonLength 单位为字节，示例值104857600对应100MB上限，可根据实际需求调整
# 路径拼接使用Join-Path避免语法错误和路径兼容问题
$inputFileJson | ConvertTo-Json -Depth 20 -MaxJsonLength 104857600 | Out-File -Encoding utf8 (Join-Path $localDir "input.json") -Force

其他键值对存储方案 #

如果需要更通用、更稳定的键值对存储能力，可参考以下方案：

• 内存存储场景：使用.NET 原生的 Dictionary<string, object> 类型，和PowerShell语法完全兼容，性能更稳定，没有额外类型转换开销
• 本地持久化小体量场景：使用INI格式文件存储，可直接调用.NET 自带的Win32 API读写INI，无需额外依赖
• 中等体量持久化场景：使用轻量级数据库Sqlite，通过PowerShell的Microsoft.Data.Sqlite模块实现结构化键值对存储，支持事务、查询等高级能力
• 跨平台序列化场景：直接使用PSCustomObject自定义对象，属性名对应键、属性值对应值，JSON/XML序列化兼容性优于原生哈希表

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