Pycharm
 
2023.3
快捷方式：Windows
获取 PyCharm
  1. 支持与帮助
  2. PyCharm 故障排除

故障排除

最后修改时间：2023 年 11 月 13 日

使用 PyCharm 时，您可能会遇到一些警告或错误消息。本章提供已知问题解决方案和变通方法的列表。

您还可以找到有关故障排除和对工作环境执行基本诊断的建议。

报告的问题

可能的原因

解决方案

项目设置

Python 解释器在“首选项/设置”|的可用解释器列表中被标记为不受支持。项目| Python解释器。

标记的解释器的 Python 版本已过时，PyCharm 不支持它

您可以从可用解释器列表中删除不受支持的解释器。有关支持的 Python 版本的更多信息，请参阅Python 支持。

代码编辑

PyCharm Editor 限制代码编辑。

您已经安装了IdeaVim插件并启用了vim编辑模式。

在“工具”菜单上取消选择“Vim 模拟器”。有关更多详细信息，请参阅在 PyCharm 中使用 Vim 编辑器模拟。

Python 代码不会在编辑器中突出显示。

PY文件与文本文件格式相关联。

在“设置”对话框 ( ) 中，导航至编辑器 | 文件类型，从“识别的文件类型”列表中选择“文本” ，从“文件名模式”列表中选择*.py，然后单击。CtrlAlt0S消除

代码完成

代码完成操作不可用。

省电模式已启用。

从主菜单中，选择“文件”并清除“省电模式”复选框。

您的文件不驻留在内容根中，因此它无法获取代码完成所需的类定义和资源。

重组您的源文件。

包含您希望出现在完成建议列表中的类和函数的文件是纯文本文件。

重新考虑并修改（如果需要）源文件的格式。

调试

无法调试 Docker 运行/调试配置；调试操作不可用。

PyCharm 提供 Python 运行/调试配置的调试。

配置基于 Docker 的解释器并在 Docker 容器中调试 Python 脚本。

Python 调试器在调试 Gevent 代码时挂起。

Gevent 兼容模式未启用。

在“设置”对话框 ( ) 中，导航至“构建、执行、部署”| Python 调试器并选择Gevent 兼容复选框。CtrlAlt0S

PyQt 代码中报告了一些导入错误。

PyQt 安装在解释器上，但未导入应用程序代码中。

在“设置”对话框 ( ) 中，导航至“构建、执行、部署”| Python 调试器，并清除. 该模式默认启用。CtrlAlt0S

调试过程很慢。

调试器不仅在进程因异常终止时停止，而且在抛出每个异常时停止（即使它被捕获并且没有导致进程终止）。

清除“断点”对话框中的“引发时”复选框（“运行”|“查看断点”）。

第一次尝试附加到本地进程时会出现以下错误消息：ptrace: Operation not permitted。

这是 Ubuntu 的一个已知问题。

确保kernel.yama.ptrace_scope内核参数设置为 0。您可以使用该命令临时更改其值，也可以通过将该行添加到/etc /sysctl.d /10-ptrace.confsudo sysctl kernel.yama.ptrace_scope=0文件来永久设置它。kernel.yama.ptrace_scope = 0

Cython 加速

显示以下错误消息：

Python.h: no such file or directory。

您缺少 Python 的头文件和静态库。

python-dev使用包管理器在系统范围内安装包。

在 Linux 和 macOS 上，您可以运行以下命令：

sudo apt-get install python-dev

要安装特定 Python 版本的包，请使用python-dev<version>. 例如：

sudo apt-get install python3.11-dev

显示以下错误消息：

Command 'gcc' failed with exit status 1。

你缺少一个C编译器。

安装 C 编译器以便为调试器构建 Cython 扩展。有关更多信息，请参阅Cython 文档。

您已单击Cython 加速扩展通知中的安装链接，但 PyCharm 反复提示安装它。

您无权在PyCharm 使用的目录中进行写入。

检查并修改您的权限。

包装

包安装失败。

pip不适用于特定的 Python 解释器，或者不满足任何安装要求。

  • 如果pip不可用，请安装所需的 Python 解释器（请参阅相应的故障排除提示）

  • 请查阅特定包的产品文档，以确保它可以安装在您的操作系统中并适用于目标 Python 解释器。另外，检查是否应满足任何其他系统要求。

Docker（参考Docker故障排除）

文件观察程序您可能会在“首选项/设置” | 文件观察程序中注意到以下消息。工具| 文件观察者窗口。

Unknown Scope error

文件观察器使用此项目中未定义的范围。

双击观察器并选择一个可用范围或创建一个新范围。

Not found error

该项目使用已删除的全局文件观察器。

使用“删除”按钮从列表中删除观察器消除，或对其进行编辑以创建具有相同名称的新全局观察器。

部署

使用 SSH 配置时出现错误消息：

Connection to <server> failed: SSH: invalid privatekey: [<key>. SSH: invalid privatekey: <key>

PyCharm 不支持 OpenSSH 密钥的 RFC 4716 格式。

  • ssh-agent使用命令添加私钥ssh-add（更多详细信息请访问ssh.com）

  • 在“添加 Python 解释器”对话框中重复配置步骤。

“运行”菜单中没有“配置文件”命令。

  • 此功能仅在 PyCharm 专业版中可用。

  • 与 PyCharm Professional 捆绑在一起的图表插件已被禁用。

检查 PyCharm 的版本并在插件设置中启用图表插件。

在某些情况下，您可能需要执行诊断步骤来确定问题是出现在 PyCharm 还是您的工作环境中。以下是有用的提示和技巧的列表。

故障排除技巧

故障排除案例

诊断行动

在 PyCharm 和终端窗口中运行应用程序时，您会遇到不同的应用程序行为。

使用 PyCharm 项目设置中指定的 python 版本运行脚本：

  1. 在 PyCharm 中，打开“设置”对话框，导航到“项目 <项目名称> |” Python解释器。CtrlAlt0S

  2. 单击Python 解释器口译员字段附近并选择显示全部...。您在项目中使用的解释器将在可用解释器列表中选择。

  3. 单击并复制解释器路径编辑口译员字段中的路径。

  4. 现在，使用复制的路径在终端窗口中运行脚本

    <copied python interpreter path> <path to the python script>\my_script.py。例如，C:\Python27\python.exe C:\Samples\my_script.py

如果您的应用程序的行为仍然不同，请联系支持服务pycharm-support@jetbrains.com

未安装特定 Python 解释器所需的包。为特定 Python 解释器安装的软件包版本已过时。

运行以下命令来安装所需的包：

<path to the python executable>\python.exe -mpip install '<package>'

例如，C:\Python27\python.exe -mpip install 'Flask'

执行后，这些命令将安装指定软件包的最新版本。

要安装特定版本的软件包，请使用以下表达式：

  • '<package>==<package_version>'– 安装特定版本的软件包

  • '<package>>=<package_version>'– 安装高于指定或更高版本的软件包

  • '<package>~=<package_version>'– 安装与指定版本的软件包兼容的版本

例如，以下命令安装与版本 1.0.2 兼容的 Flask：C:\Python27\python.exe -mpip install 'Flask~=1.0.2'

当尝试安装软件包时，您发现 pip 对于特定的 Python 解释器不可用。

尝试从标准库引导 pip：

<path to the python executable>\python.exe -m ensurepip --default-pip

例如，C:\Python27\python.exe -m ensurepip --default-pip

有关 pip 安装的更多信息，请参阅packaging.python.org