PowerShell脚本传递变量给Docker run命令报错原因排查

问题场景 #

直接在命令行执行以下命令可正常运行：

docker run -t -i -w=[absolute_work_dir] [docker_image] [executable]

但在PowerShell脚本（.ps1）中通过变量设置工作目录时：

$WORKDIR = [absolute_work_dir]
docker run -t -i -w=$WORKDIR [docker_image] [executable]

出现错误提示：

docker: Error response from daemon: the working directory '$WORKDIR' is invalid, it needs to be an absolute path.

可能的原因 #

• 变量未被正确解析：PowerShell在处理-w=$WORKDIR时，没有将$WORKDIR解析为变量存储的实际路径，而是把字面量$WORKDIR直接传给了Docker，Docker无法识别这个字符串为合法绝对路径，因此报错。
• 路径含特殊字符/空格导致解析异常：如果你的绝对路径包含空格、括号等特殊字符，直接使用-w=$WORKDIR会让PowerShell对参数的解析出现偏差，导致传给Docker的路径不完整或格式错误。
• 变量赋值不规范：检查$WORKDIR的赋值语句，如果路径本身带空格但赋值时没加引号，变量只会存储路径的前半部分，最终传给Docker的内容并非完整的绝对路径。

解决方法 #

针对上述原因，可通过以下方式修正：

1. 用双引号包裹-w参数，强制PowerShell解析变量：

docker run -t -i "-w=$WORKDIR" [docker_image] [executable]

2. 用大括号明确标记变量范围，避免解析歧义：

docker run -t -i -w=${WORKDIR} [docker_image] [executable]

3. 确保变量赋值时路径格式正确，带特殊字符的路径必须用双引号包裹：

$WORKDIR = "C:\Path With Spaces"
docker run -t -i -w="$WORKDIR" [docker_image] [executable]

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