PhpStorm 2025.2 Help

Docker 排错

JetBrains 正在不断为 Docker 插件进行修复和改进。 您可以在我们的错误跟踪系统中找到 已知 Docker 问题和功能请求列表 ,并对最影响您的问题进行投票。 您还可以提交自己的错误报告和功能请求。

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

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

确保:

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

无法使用 Docker Compose 运行多容器应用程序

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

Docker Compose 在 Ubuntu 上通过 Unix socket 设置无法运行

在 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.

在这种情况下,请在 引擎 API URL 字段中使用 TCP 套接字 连接 unix:///var/run/docker.sock。 如需更多信息,请参阅 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 文件与正确的类型关联

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

如果 与文件类型关联… 操作被禁用,这可能意味着该文件名已被注册为某些其他文件类型的模式。 例如,如果您有一个自定义名称的 Dockerfile 并被识别为文本文件,您无法将其与 Dockerfile 类型关联。 要移除文件类型模式,请执行以下操作:

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

  2. 选择相关的文件类型(在本例中: 文本 )并删除文件名的模式。

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

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

通过服务连接到 Docker 时的高 CPU 使用率

如果您在 Windows 上使用 Hyper-V 作为 Docker 服务的后端,防病毒软件将不断扫描 Hyper-V 虚拟磁盘文件 ( .vhdx ),即使没有容器运行,这也会导致 CPU 资源的过度消耗。

在这种情况下,将 Hyper-V 虚拟磁盘文件排除在防病毒扫描之外。

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