Windows容器Docker build报错：COPY文件找不到问题求助

问题详情 #

本地创建构建目录，包含Dockerfile及所有上下文文件，当前Dockerfile核心内容：

# escape=`
FROM mcr.microsoft.com/windows/servercore:20H2
ARG VSPath
ENV VSPath=${VSPath:-"C:\VsBuildInstall\"}
COPY [ "\LocalLayout\", $VSPath ]
...

执行构建命令：

docker build --rm -t test:latest '.'

出现报错：

Step 9/12 : COPY [ "\LocalLayout\", $VSPath ]
COPY failed: file not found in build context or excluded by .dockerignore: stat LocalLayout\,: file does not exist

错误原因 #

问题出在COPY指令的JSON格式路径转义处理：

1. JSON字符串中反斜杠需要双重转义，你仅写了单个反斜杠，导致Docker解析时错误地将路径末尾的引号、逗号纳入路径范围，最终查找LocalLayout\,:这个不存在的文件。
2. 此外，COPY复制目录时，末尾的反斜杠是多余的，Docker会自动识别目录并完成递归复制。

解决方法 #

方法1：修正JSON格式的COPY指令

将源路径的反斜杠双重转义，可选择保留或移除末尾反斜杠：

# 移除末尾反斜杠的写法
COPY [ "\\LocalLayout", "$VSPath" ]

# 保留末尾反斜杠的写法（同样需双重转义）
COPY [ "\\LocalLayout\\", "$VSPath" ]

方法2：使用非JSON格式的COPY指令

避开JSON的转义麻烦，采用更直观的普通格式：

COPY LocalLayout\ "${VSPath}"

额外检查项 #

• 确认LocalLayout目录确实在构建上下文（即Dockerfile所在目录）中，且未被.dockerignore文件排除。
• 建议修正环境变量默认值的路径转义，避免潜在问题：

# 双重反斜杠写法
ENV VSPath=${VSPath:-"C:\\VsBuildInstall\\"}
# 或使用正斜杠（Docker Windows容器兼容正斜杠路径）
ENV VSPath=${VSPath:-"C:/VsBuildInstall/"}

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