如何在PowerShell中将变量插入URI以调用第三方API？

核心问题 #

直接拼接变量到URI时，容易遇到两个坑：

1. PowerShell对字符串中变量的解析歧义（比如变量后紧跟特殊字符）
2. 变量值包含URL特殊字符（如空格、&、=等）时，未编码导致URI无效

正确实现方式 #

方法1：明确变量解析范围 #

如果变量是简单值，用$($data)明确告诉PowerShell解析整个变量，避免和后续字符混淆：

$uri = "https://mickeymouse.tv.com/api/table/radio?sysparm_query=short_description%3D$($data)&sysparm_limit=1"

方法2：强制URL编码（推荐） #

如果$data的值包含空格、特殊符号，必须进行URL编码，否则API无法正确解析参数。用[Uri]::EscapeDataString()处理变量：

$encodedData = [Uri]::EscapeDataString($data)
$uri = "https://mickeymouse.tv.com/api/table/radio?sysparm_query=short_description%3D$encodedData&sysparm_limit=1"

方法3：字符串格式化拼接 #

用-f运算符拼接，可读性更强：

$encodedData = [Uri]::EscapeDataString($data)
$uri = "https://mickeymouse.tv.com/api/table/radio?sysparm_query=short_description%3D{0}&sysparm_limit=1" -f $encodedData

之前写法失败的原因 #

• 直接用$data：若$data是复杂对象，会输出对象类型名而非属性值；若变量后有特殊字符，PowerShell可能解析错误
• 加单引号'$data'：PowerShell中单引号会原样输出变量名，不会替换为实际值，导致API收到的是字符串'$data'而非变量内容

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