WebStorm 2025.2 Help

Docker 故障排除

JetBrains 正持续改进 Docker 插件并修复缺陷。 您可以在我们的缺陷跟踪系统中找到 已知 Docker 问题和功能请求列表 ,并为影响您的条目投票。 您也可以提交自己的缺陷或功能请求。

如果遇到下列问题,请尝试相应的建议解决方案:

无法从 WebStorm 连接到 Docker 守护进程

请确保以下事项:

有关更多信息,请参阅 Docker 连接设置

无法通过 Docker Compose 运行多容器应用

请确保在 设置 对话框 Ctrl+Alt+S 中的 构建、执行、部署| Docker| 工具 下正确指定 Docker Compose 可执行文件。 有关更多信息,请参阅 Docker 连接设置

在 Ubuntu 上通过 Unix 套接字设置无法使用 Docker Compose

在 Ubuntu 上运行 Docker Compose 时,显示以下错误信息:

docker.errors.TLSParameterError: Path to a certificate and key files must be provided through the client_config param. TLS configurations should map the Docker CLI client configurations.

此时,请在 Engine API 地址 字段中使用带有 unix:///var/run/docker.sockTCP 套接字 连接。 有关更多信息,请参阅 TCP 套接字

无法使用端口绑定

请确保已公开相应的容器端口。 请在您的 Dockerfile 中使用 EXPOSE 命令。

无法从镜像仓库中拉取镜像

尝试从镜像仓库中拉取 Docker 镜像时,会显示以下消息:

Failed to parse dockerCfgFile: <your_home_dir>/.docker/config.json, caused by: ... {"credsStore":"wincred"}

此时,请转到 <your_home_dir>/.docker 目录并删除 config.json 文件。

无法将 Dockerfile 和 Docker Compose 文件关联为正确类型

默认情况下,WebStorm 应能根据名称和内容识别 Dockerfile 和 Docker Compose 文件。 这将启用多个代码辅助功能,例如补全建议、检查和行号图标。 如果 WebStorm 无法识别某个文件,它会提示您手动指定文件类型。 要将现有文件关联为正确类型,请在 项目 工具窗口中右键点击该文件,然后在上下文菜单中选择 与文件类型关联…

如果 与文件类型关联… 操作被禁用,这可能是因为文件名已被注册为其他文件类型的模式。 例如,如果您使用了自定义命名的 Dockerfile 且该文件被识别为文本文件,那么就无法将其关联为 Dockerfile 类型。 要删除文件类型模式,请执行以下操作:

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 文件类型

  2. 选择相关的文件类型(在此示例中为: 文本 ),并移除与文件名对应的模式。

  3. 点击 确定(O) 应用更改。

现在,您应能使用上下文菜单中的 与文件类型关联… 设置正确的文件类型。

通过服务连接 Docker 时 CPU 占用率过高

如果您在 Windows 上使用 Hyper-V 作为 Docker 服务的后台,杀毒软件会持续扫描 Hyper-V 虚拟磁盘文件( .vhdx ),即使没有容器运行,也会导致 CPU 资源占用过高。

此时请将 Hyper-V 虚拟磁盘文件从杀毒扫描中排除。

最后修改日期: 2025年 9月 26日