PyCharm 2026.1 Help

Dev 容器问题疑难解答

以下是在使用 Dev 容器期间可能出现的一些问题及其解决方案。

我遇到空白的正在构建 Dev 容器对话框,且按钮被禁用

请尝试检查 Docker,如其无响应,请重启 Docker。

在 Windows 10 上,通过 SSH 进行连接非常缓慢

OpenSSH 版本 升级到 8.5 或更高版本。

Git clone 无法工作,尽管已添加密钥,客户端中打开的项目仍为空

请尝试检查以下内容:

  • 检查 OpenSSH 客户端是否已在系统变量的 PATH 中: C:\Windows\System32\OpenSSH\ ,并重启操作系统。

  • 运行命令以启动 SSH 代理,并添加密钥。

  • 将 SSH 密钥的权限更改为 600(仅所有者可读;其他用户不可读或写)。

可能出现 UI 冻结

当 WSL 虚拟机在其上运行 ijent 进程时被挂起,UI 可能会冻结。 PyCharm 无法检测到连接已终止,因为 ijent 进程本身并未停止——它只是停止响应请求,导致所有请求挂起。

导致此行为的潜在原因包括:

  • docker container pause (手动或通过 Docker Desktop 调用)会挂起容器。 如果在 IDE 中当前打开了开发容器、过去曾打开过,或用户尝试打开它,都可能导致 UI 冻结。

  • 在 Windows 上,由于 Docker 中的 问题 ,Docker Desktop 的 暂停Resource Saver 功能可能导致 WSL 挂起。 这意味着,即使是在 PyCharm 中从不打开 Docker 项目、但同时处理 WSL 项目并使用 Docker 的用户,也可能遇到由 Docker Desktop 干扰引起的问题。 我们建议在 Windows 上的 Docker Desktop 中始终禁用 Resource Saver 选项,并避免使用 暂停 选项。

2026年 3月 24日