在使用 PyCharm 时,您可能会遇到一些警告或错误消息。本章提供了已知问题解决方案和变通方法的列表。
您还可以找到对您的工作环境进行故障排除和执行基本诊断的建议。
报告的问题 | 可能的原因 | 解决方案 |
---|---|---|
项目设置 | ||
在 。 | 标记解释器的 Python 版本已过时,PyCharm 不支持 | 您可以从可用解释器列表中删除不受支持的解释器。有关支持的 Python 版本的更多信息,请参阅Python 支持。 |
代码编辑 | ||
PyCharm Editor 限制代码编辑。 | 您已经安装了IdeaVim插件,因此启用了 vim 编辑模式。 | 取消选择Vim 模拟器。有关更多详细信息,请参阅在 PyCharm 中使用 Vim 编辑器仿真。 菜单上的 |
Python 代码未在编辑器中突出显示。 | PY文件与文本文件格式相关联。 | 在Settings/Preferences对话框 ( Ctrl+Alt+S) 中,导航到 ,从已识别的文件类型列表中选择文本,从文件名模式列表中选择*.py,然后单击。 |
代码完成 | ||
代码完成操作不可用。 | 启用省电模式。 | 从主菜单中,选择文件并清除省电模式复选框。 |
您的文件不驻留在内容根目录中,因此它没有获得代码完成所需的类定义和资源。 | 重组您的源文件。 | |
包含您希望出现在完成建议列表中的类和函数的文件是纯文本文件。 | 重新考虑并修改(如果需要)源文件的格式。 | |
调试 | ||
无法调试 Docker 运行/调试配置;调试操作不可用。 | PyCharm 为 Python 运行/调试配置提供调试。 | 配置基于 Docker 的解释器并在 Docker 容器中调试 Python 脚本。 |
Python 调试器在调试 Gevent 代码时挂起。 | 未启用 Gevent 兼容模式。 | 在Settings/Preferences对话框 ( Ctrl+Alt+S) 中,导航到 并选中Gevent 兼容复选框。 |
您的 PyQt 代码中报告了一些导入错误。 | PyQt 安装在解释器上,但未在应用程序代码中导入。 | 在Settings/Preferences对话框 ( Ctrl+Alt+S) 中,导航到Python ,并清除. 此模式默认启用。 |
调试过程很慢。 | 调试器不仅在进程以异常终止时停止,而且在每个抛出异常时停止(即使它被捕获并且没有导致进程终止)。 | 清除Breakpoints对话框( )中的On raise复选框。 |
在您第一次尝试附加到本地进程时出现以下错误消息: | 这是 Ubuntu 的一个已知问题。 | 确保将 |
Cython 加速 | ||
显示以下错误消息:
| 你缺少 Python 开发的头文件和静态库。 | 使用包管理器为 Python 开发系统范围安装头文件和静态库。 例如,您可以使用以下命令:
|
显示以下错误消息:
| 您缺少 C 编译器。 | 安装 C 编译器以便为调试器构建 Cython 扩展。 |
您已经单击了Cython 加速扩展通知中的安装链接,但 PyCharm 反复提示安装它。 | 您无权写入PyCharm 使用的目录。 | 检查并修改您的权限。 |
打包 | ||
包安装失败。 | pip不适用于特定的 Python 解释器,或者不满足任何安装要求。 |
|
Docker | ||
无法连接到 Docker | Docker 未运行,或者您的 Docker 连接设置不正确。 | 在Settings/Preferences对话框 ( Ctrl+Alt+S) 中,选择 ,然后在Connect to Docker daemon with下为 <您的操作系统> 选择 Docker。例如,如果您使用的是 macOS,请选择Docker for Mac。在Docker 设置中查看更多详细信息。 如果您使用的是 Docker Toolbox,请确保 Docker Machine 正在运行,并且在Build、Execution、Deployment |下的Settings/Preferences对话框中正确指定了其可执行文件。Docker | 工具。Ctrl+Alt+S |
Docker-composer 不适用于使用 unix 套接字设置的 Ubuntu。 | Docker-composer 报以下错误:
docker.errors.TLSParameterError:必须通过 client_config 参数提供证书和密钥文件的路径。TLS 配置应该映射 Docker CLI 客户端配置。
|
|
当您尝试拉取图像时,会显示以下消息:
| 使用时验证配置文件无效:http | 转到<your_home_dir>/.docker目录并删除config.json文件。 |
无法使用 Docker 撰写 | Docker Compose 可执行文件指定不正确。 | 在Build, Execution, Deployment |下的Settings/Preferences对话框中指定 Docker Compose 可执行文件 Docker | 工具Ctrl+Alt+S |
无法使用端口绑定 | 容器端口不暴露。 | 在Dockerfile中使用EXPOSE命令 |
通过服务连接到 Docker 时 CPU 使用率很高。 | When Hyper-V is selected as the backend for the Docker service on Windows, Hyper-V virtual disk files ( .vhdx ) are constantly scanned by the anti-virus software. 这种行为会导致 CPU 的过度消耗,即使没有容器在运行。 | 从防病毒扫描中排除 Hyper-V 虚拟磁盘文件。 |
文件观察器您可能会注意到 中的以下消息。 器窗口。 | ||
| File Watcher 使用了此项目中未定义的范围。 | 双击观察者并选择一个可用范围或创建一个新范围。 |
| 该项目使用已删除的全局文件观察器。 | 使用Remove按钮从列表中删除观察者, |
部署 | ||
使用 SSH 配置时的错误消息:
| PyCharm 不支持 OpenSSH 密钥的 RFC 4716 格式。 | |
配置文件命令在运行菜单中不可用。 |
| 检查 PyCharm 的版本并在插件设置中启用图表插件。 |
在某些情况下,您可能需要执行诊断步骤来确定问题是出现在 PyCharm 中还是在您的工作环境中。以下是有用的提示和技巧的列表。
故障排除案例 | 诊断动作 |
---|---|
在 PyCharm 和终端窗口中运行应用程序时,您会遇到不同的行为。 | 使用 PyCharm 项目设置中指定的 python 版本运行脚本:
如果您的应用程序的行为仍然不同,请联系支持服务pycharm-support@jetbrains.com |
没有为特定的 Python 解释器安装所需的包。为特定 Python 解释器安装的软件包版本已过时。 | 运行以下命令来安装所需的包:
例如, 执行后,这些命令会安装指定软件包的最新版本。 要安装特定版本的软件包,请使用以下表达式:
例如,以下命令会安装与 1.0.2 版本兼容的 Flask:
例如, 执行后,这些命令会安装指定软件包的最新版本。 要安装特定版本的软件包,请使用以下表达式:
例如,以下命令会安装与 1.0.2 版本兼容的 Flask: |
尝试安装软件包时,您发现 pip 不适用于特定的 Python 解释器。 | 尝试从标准库引导 pip:
例如,
例如, 有关 pip 安装的更多信息,请参阅Packaging.python.org |