powershell 参数带空格

PowerShell 默认使用双引号 () 来定义一个包含空格的单一参数单元。

下面我将从最简单的情况到更复杂的情况,详细解释如何处理带空格的参数。

基本情况：为脚本/函数传递带空格的参数

假设你有一个名为 MyScript.ps1 的脚本,内容如下：

# MyScript.ps1
param (
    [string]$Path,
    [string]$Message
)
Write-Host "参数 Path 的值是: $Path"
Write-Host "参数 Message 的值是: $Message"

你想调用这个脚本,并传入一个包含空格的路径和一条消息。

错误的调用方式（不使用引号）

如果你直接这样写，PowerShell 会把 C:\My Documents 拆分成两个独立的参数：

# 错误！这会导致参数数量不匹配
.\MyScript.ps1 C:\My Documents "Hello World"

PowerShell 会尝试将 C:\My 赋值给 $Path，Documents 赋值给 $Message，而 "Hello World" 则因为位置错误而被忽略,导致错误。

正确的调用方式（使用双引号）

使用双引号 () 将包含空格的值括起来，告诉 PowerShell 这是一个整体。

# 正确！双引号将包含空格的值组合成一个参数
.\MyScript.ps1 "C:\My Documents" "Hello World"

执行结果：

参数 Path 的值是: C:\My Documents
参数 Message 的值是: Hello World

为什么用双引号而不是单引号？

• 双引号 ()：可扩展，引号内的变量（如 $env:USERNAME）会被替换成其实际值。
• 单引号 ()：字面量，引号内的所有内容都作为普通文本处理,变量不会被解析。

示例：

$User = "Alice"
.\MyScript.ps1 "C:\My Documents" "Hello, $User"  # 输出: Hello, Alice
.\MyScript.ps1 "C:\My Documents" 'Hello, $User'  # 输出: Hello, $User

在命令行（CMD/Bash）中调用 PowerShell 脚本

当你在一个传统的命令提示符（cmd.exe）或 PowerShell 自身（有时为了转义）中调用脚本时，情况会变得稍微复杂一些，因为外层 shell 也会尝试解释引号。

场景： 你想在 cmd.exe 中运行上面的 MyScript.ps1。

最安全、最推荐的方法是使用 -File 参数，并用转义字符 ` (反引号) 来转义内层的引号。

在 PowerShell 中，反引号 ` 是转义字符,可以将其后面的下一个字符的字面值传递下去。

# 在 PowerShell 或 CMD 中都可以这样用
powershell.exe -File "C:\path\to\MyScript.ps1" "C:\My Documents" "Hello World"

在 CMD.exe 中的等效写法： CMD 也支持用反引号转义,但写法略有不同。

# 在 CMD.exe 中
powershell.exe -File "C:\path\to\MyScript.ps1" "C:\My Documents" "Hello World"

在 CMD 中，双引号本身已经起到了很好的作用，所以通常不需要额外的转义，但为了确保万无一失，尤其是在路径和参数都包含引号时,转义是必要的。

高级用法：$args 数组和 停止解析

1 使用 $args 数组捕获未命名参数

如果你的脚本或函数没有使用 param 块定义参数，你可以使用自动变量 $args 来捕获所有传入的参数。$args 是一个数组,每个元素就是一个参数。

示例脚本 Get-Args.ps1：

# Get-Args.ps1
for ($i = 0; $i -lt $args.Count; $i++) {
    Write-Host "参数 [$i] 的值是: $($args[$i])"
}

调用方式：

.\Get-Args.ps1 第一个参数 "第二个参数 带空格" 第三个

执行结果：

参数 [0] 的值是: 第一个参数
参数 [1] 的值是: 第二个参数 带空格
参数 [2] 的值是: 第三个

可以看到，即使没有用 param 定义，PowerShell 依然正确地将 "第二个参数 带空格" 识别为一个单一的参数。

2 使用 (停止解析) 特殊参数

这是一个非常强大的功能，当你需要将大量参数原封不动地传递给一个外部程序（特别是那些不理解 PowerShell 语法的老旧程序）时， 就派上用场了。

当 PowerShell 在命令行中看到 时，它会停止对后续参数的所有解析,并将它们逐字传递给命令。

示例： 假设你有一个老旧的命令行工具 old_tool.exe，它的用法是： old_tool.exe /option:"some value with spaces"

在 PowerShell 中直接调用可能会失败，因为 PowerShell 会尝试解释引号和空格，这时可以使用 。

# PowerShell 会停止解析 "old_tool.exe" 之后的所有内容
old_tool.exe --% /option:"some value with spaces" /another_option

PowerShell 会把 /option:"some value with spaces" /another_option 这整个字符串原封不动地交给 old_tool.exe 处理，就像在 CMD 中运行一样。

注意： 必须紧跟在可执行文件名称之后。

总结与最佳实践

记住这个黄金法则：在 PowerShell 中，用双引号来“粘合”带空格的参数。 这能解决 99% 的问题。