在自动化运维与脚本编程领域，批处理文件（.bat）至今仍是Windows环境下不可或缺的利器。然而，当批处理脚本需要与现代应用程序或云服务交换数据时，传统的纯文本参数格式往往力不从心——JSON（JavaScript Object Notation）凭借其结构化、易解析的特性，成为首选的数据交换格式。如何将批处理参数高效、可靠地转换为JSON？本文将剖析几种主流方案，助你打通“传统脚本”与“现代数据”之间的最后一公里。

一、为什么需要转换？

试想一个典型的场景：你的批处理脚本接收了若干个参数——用户名、密码、文件路径、时间戳等，这些参数原本通过%1、%2等位置变量传递，格式松散，无法直接传递给需要JSON输入的REST API、数据库或云函数。手动拼接JSON字符串不仅容易出错（如引号嵌套、特殊字符转义），而且当参数数量或数据类型变化时，维护成本极高。自动化的参数转JSON方案，能大幅提升脚本的鲁棒性与互操作性。

二、三大主流转换方法

1. PowerShell桥接法：原生JSON支持最省心

PowerShell内置了强大的ConvertTo-Json cmdlet，可直接将对象或哈希表序列化为JSON。批处理脚本可以通过powershell -Command调用PowerShell代码，实现参数转换。

示例： 假设批处理脚本接收三个参数：serverName、port、isSSL。

@echo off
setlocal
set "serverName=%~1"
set "port=%~2"
set "isSSL=%~3"

powershell -Command "
$params = @{
    serverName = '%serverName%'
    port = [int]'%port%'
    isSSL = [bool]::Parse('%isSSL%')
}
$json = $params | ConvertTo-Json -Compress
Write-Output $json
"
endlocal

优点： 代码简洁，自动处理类型转换与转义；支持嵌套对象、数组等复杂结构。
缺点： 依赖PowerShell环境，在极简的Windows Server Core或受限环境中可能不可用。

2. 纯批处理＋第三方工具jq：轻量级万能方案

若想完全避免PowerShell，可以借助跨平台轻量级JSON处理工具jq。将参数先拼接成键值对文本，再通过jq转换为JSON。需要提前将jq.exe放到脚本同级目录或PATH路径下。

示例： 先构造一个临时的键值对文件，再用jq格式化。

@echo off
setlocal enabledelayedexpansion
set "arg1=%~1"
set "arg2=%~2"
set "arg3=%~3"

(
echo {"arg1":"!arg1!","arg2":"!arg2!","arg3":"!arg3!"}
) > temp.json

jq . temp.json
del temp.json
endlocal

进阶技巧： 利用jq的--arg参数直接从环境变量赋值，避免手动拼接JSON字符串的脆弱性：

jq -n --arg sn "%1" --arg po "%2" --arg ssl "%3" '{serverName: $sn, port: $po, isSSL: $ssl}' > output.json

优点： 不依赖PowerShell，jq体积仅数百KB，运行极快；支持复杂过滤、校验。
缺点： 需额外下载jq；对于非字符串类型的参数（如数字、布尔值），需手动调整jq表达式。

3. 利用Windows Shell JSON库：企业级自动化

对于大规模或频繁执行的转换任务，可考虑使用微软官方或社区提供的JSON库（如Json.NET的JsonReaderWriterFactory），通过C#或JScript编写封装。例如，将参数写入临时XML，再用.NET的System.Runtime.Serialization.Json序列化。但这对运维人员门槛较高，通常仅推荐在需要高度定制化的CI/CD流水线中使用。

三、避坑指南：转义与类型

无论采用哪种方法，都必须注意以下陷阱：

  • 引号转义： 批处理参数可能包含双引号（如带空格的路径），在使用PowerShell或jq时需确保引号正确传递。建议在批处理中先用%~1去掉外层引号，再在JSON构造时重新加引号。
  • 数据类型： 默认为字符串，需要显式处理数字（如[int]'%port%'）和布尔值（如[bool]::Parse('%isSSL%')）的转换。
  • 特殊字符： 参数中包含反斜杠、换行符等，需在生成JSON前做转义（\变为\\，换行变为\n等）。

四、行业实践与前景

在DevOps领域，Microsoft的Azure DevOps Pipeline以及GitLab CI等工具均支持在脚本阶段生成JSON变量，以实现动态配置注入。例如，许多运维团队将一个批处理脚本封装成“参数提取器”，自动将用户输入映射为JSON格式，再传递给下游的Terraform或Ansible。此外，随着Windows对WSL（Windows Subsystem for Linux）的深度支持，部分开发者开始在批处理中内联Bash命令，利用echo和jq实现更灵活的转换。

结语

批处理参数转JSON看似是一个小需求，却是弥合传统脚本世界与现代云原生数据生态的桥梁。从轻量的PowerShell一行命令，到可靠的jq工具链，再到企业级的.NET序列化，技术选型应基于实际环境约束、团队技能树与性能要求。掌握这些方法，你将能让老旧的.bat文件焕发新生，从容应对API接口、数据库写入及配置文件生成等场景。未来，随着Windows对跨平台工具链的进一步拥抱，这一转换过程无疑将变得更加透明与自动化。