Windows环境下Swagger Editor Docker启动命令问题求助

可能的原因及对应解决方案 #

1. 路径格式与空格问题 #

Windows CMD中%cd%会输出带反斜杠的本地路径，且若路径含空格，直接映射会导致Docker解析失败。需给路径添加引号，确保格式兼容：
docker run -d -p 80:8080 -v "%cd%:/tmp" -e SWAGGER_FILE=/tmp/swagger.yaml swaggerapi/swagger-editor

2. Docker驱动器共享未开启 #

Docker Desktop默认可能未授权访问本地盘符，需手动开启：

• 打开Docker Desktop设置
• 进入资源 > 文件共享
• 勾选当前目录所在的盘符（如C盘）
• 点击应用并重启Docker

3. 本地文件不存在或路径不匹配 #

• 确认当前CMD窗口的工作目录下，确实存在swagger.yaml文件
• 环境变量SWAGGER_FILE中的文件名需与本地文件名完全一致（容器内路径区分大小写）

4. 使用绝对路径替代相对路径 #

若相对路径仍有问题，直接使用本地绝对路径（注意用引号包裹）：
docker run -d -p 80:8080 -v "C:\projects\api-docs:/tmp" -e SWAGGER_FILE=/tmp/swagger.yaml swaggerapi/swagger-editor

内容的提问来源于stack exchange，提问作者J.Doe