为何Docker命令在VS Code中提示无效格式？

问题原因 #

这个错误通常是Docker错误解析了命令参数导致的，最常见的情况是挂载卷的路径格式不符合当前终端要求，使得Docker误将路径的部分内容判定为镜像名称。针对Windows系统下VS Code的不同终端环境，解决方案如下：

分终端解决方案 #

1. 命令提示符（Command Prompt/CMD） #

将整个挂载参数用引号包裹，修正后的命令：

docker run -it -v "%cd%:/e2e" -w /e2e cypress/included:6.2.1 --browser chrome

注意：原命令中"%cd%":/e2e的引号位置错误，需把%cd%:/e2e整体放在引号内，避免路径含空格时参数被拆分。

2. PowerShell #

PowerShell不支持%cd%变量，需用${PWD}替代，同时包裹整个挂载参数：

docker run -it -v "${PWD}:/e2e" -w /e2e cypress/included:6.2.1 --browser chrome

3. WSL 2终端（如Ubuntu on WSL） #

若VS Code使用WSL终端，需将Windows路径转换为WSL格式（例如C:\projects\e2e对应/mnt/c/projects/e2e），命令示例：

docker run -it -v "/mnt/c/projects/e2e:/e2e" -w /e2e cypress/included:6.2.1 --browser chrome

也可在WSL终端进入对应项目目录后，使用$PWD：

docker run -it -v "$PWD:/e2e" -w /e2e cypress/included:6.2.1 --browser chrome

通用排查技巧 #

如果以上方法仍无效，直接使用绝对路径替换环境变量，规避终端环境变量解析问题，例如：

docker run -it -v "C:\your\full\project\path:/e2e" -w /e2e cypress/included:6.2.1 --browser chrome

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