PyCharm 2025.2 Help

安装 PyCharm

PyCharm 是一个跨平台的 IDE，在 Windows、macOS 和 Linux 上提供一致的体验。

PyCharm 现在作为一个统一的单一产品提供。

有哪些更改：

社区版现在是统一的 PyCharm 产品的一部分：

  • PyCharm 的核心功能始终免费且开源。

  • Jupyter 支持现已包含在核心功能中。

您可以像往常一样升级到 PyCharm Community 2025.1，无需立即进行任何更改。

当您安装 PyCharm 时，您将自动获得 30 天的免费专业版试用，享受 PyCharm 的高级功能。

试用结束后，您将拥有以下选项：

  • 获取 Pro 订阅以继续使用高级功能。

  • 继续免费使用 PyCharm 的核心功能。

如果您已经在使用 PyCharm 专业版，您将通过现有许可证保留对所有专业功能的完全访问权限，无需进行任何更改。

有关更多信息，请参阅 统一的 PyCharm 概览。

系统要求

要求

最低

推荐

内存

2 GB 可用内存

8 GB 系统总内存

处理器

任何现代处理器

多核 CPU。 PyCharm 支持多线程进行不同的操作和处理，使其能够使用更多的 CPU 核心时速度更快。

磁盘空间

3.5 GB

至少有 5 GB 可用空间的 SSD 硬盘

显示器分辨率

1024×768

1920×1080

操作系统

以下产品的正式发布版本：

  • Microsoft Windows 10 1809 64 位或更高版本

    Windows Server 2019 64-bit 或更高版本

  • macOS 12.0 或更高版本

  • 满足以下要求的最新两个版本的 Ubuntu LTS 或 Fedora Linux 发行版：

    • Linux 内核版本 6.x

    • Gnome 或 KDE 桌面环境

    • X Window 系统 (X11)

    • GLIBC 2.28 或更高版本

不支持预发布版本。

以下内容的最新版本：

  • Windows 64 位

  • macOS

  • Ubuntu LTS 或 Fedora Linux 发行版

您无需安装 Java 即可运行 PyCharm，因为 JetBrains Runtime 已与 IDE 一起捆绑（基于 JBR 21）。

PyCharm 支持以下版本的 Python：

  • Python 2： 版本 2.7

  • Python 3： 从 3.8 版本到 3.14 版本

使用 Toolbox App 安装

JetBrains Toolbox App 是安装 JetBrains 产品的推荐工具。 使用它可以安装和管理不同的产品或同一产品的多个版本，包括 Early Access Program (EAP) 版本，必要时更新和回滚，并轻松移除任何工具。 Toolbox App 保持了一个项目列表，可以快速在正确的 IDE 和版本中打开任何项目。

安装 Toolbox App

  1. 从 Toolbox App 网页 下载 .exe 安装程序。

  2. 运行安装程序并按照向导步骤操作。

  3. 运行 Toolbox App 后，点击通知区域中的图标 Toolbox App 图标 并选择您要安装的产品。

    要安装指定版本，请点击 并选择 可用版本。

Toolbox App 中的 PyCharm
Toolbox App 中的 PyCharm

从 Toolbox App 登录到您的 JetBrains 账户，它会自动激活您安装的任何 IDE 的可用许可证。

安装 Toolbox App

  1. 从 Toolbox App 网页下载磁盘镜像 .dmg 。

  2. 将镜像挂载后，将 JetBrains Toolbox 应用程序拖动到 应用程序 文件夹。

  3. 运行 Toolbox App 后，点击主菜单中的图标并选择要安装的产品。

    要安装指定版本，请点击 并选择 可用版本。

Toolbox App 中的 PyCharm

从 Toolbox App 登录到您的 JetBrains 账户，它会自动激活您安装的任何 IDE 的可用许可证。

安装 Toolbox App

  • x86_64：

    glibc 2.17（Ubuntu 18.04 或更高版本）

  • arm64：

    glibc 2.29（Ubuntu 20.04 或更高版本）

必须包含以下软件包：

  • libxi6

  • libxrender1

  • libxtst6

  • mesa-utils

  • libfontconfig

  • libgtk-3-bin

  1. 请从 Toolbox App 网页 下载 tarball .tar.gz 。

  2. 解压 tarball 并启动可执行文件：

    tar -xzf jetbrains-toolbox-<build>.tar.gz && cd jetbrains-toolbox-<build>/bin && ./jetbrains-toolbox

  3. Toolbox App 将安装到 $HOME/.local/share/JetBrains/Toolbox/bin 并从那里运行。

    首次运行 Toolbox App 后，它将自动将 Toolbox App 图标 Toolbox App 图标 添加到主菜单中。

  4. 选择您要安装的产品。

    要安装指定版本，请点击 并选择 可用版本。

Toolbox App 中的 PyCharm

从 Toolbox App 登录到您的 JetBrains 账户，它会自动激活您安装的任何 IDE 的可用许可证。

独立安装

手动安装 PyCharm 以管理每个实例和所有配置文件的位置。 例如，如果您有一个需要特定安装位置的策略。

  1. 下载安装程序 .exe 。

    要验证安装程序的完整性，请使用 下载 页面中链接的 SHA 校验和。

  2. 运行安装程序并按照向导步骤操作。

    请注意安装向导中的以下选项

    • 64 位启动器 ：将启动图标添加到桌面。

    • 将文件夹打开为项目 ：在文件夹上下文菜单中添加一个选项，允许将选定目录作为 一个 PyCharm 项目打开。

    • .py ：建立与 Python 文件的关联，以便在 PyCharm 中打开它们。

    • 将 launchers 目录添加到 PATH ：允许从控制台运行此 PyCharm 实例，而无需指定其路径。

要运行 PyCharm，请在 Windows 启动 菜单中找到它或使用桌面快捷方式。 您还可以运行 bin 下安装目录中的启动批处理脚本或可执行文件。

  1. 下载磁盘映像。

    要验证下载的磁盘映像的完整性，请使用 下载 页面中链接的 SHA 校验和。

  2. 将镜像挂载后，将 PyCharm 应用程序拖动到 应用程序 文件夹。

从 应用程序 目录、Launchpad 或 Spotlight 运行 PyCharm 应用程序。

使用 tar 压缩包安装

  1. 下载 tarball

  2. 将 pycharm-*.tar.gz 文件解压到其他文件夹，如果当前的 下载 文件夹不支持文件执行：

    tar xzf pycharm-*.tar.gz -C <new_archive_folder>

    根据文件系统层次结构标准 (FHS)，推荐的安装位置是 /opt 。 要将 PyCharm 安装到此目录，请输入以下命令：

    sudo tar xzf pycharm-*.tar.gz -C /opt/

    要验证下载的归档文件的完整性，请使用 下载 页面中链接的 SHA 校验和。

  3. 切换到 bin 子目录：

    cd <new archive folder>/pycharm-*/bin

    例如，

    cd /opt/pycharm-2022.2.4/bin

  4. 从 bin 子目录运行 pycharm 。

    ./pycharm

创建桌面条目

  1. 在主菜单中，转到 工具 | 创建桌面条目。

  2. 请点击屏幕左上角的 活动。

  3. 请点击仪表板中的网格按钮以显示所有应用程序。

  4. 要将应用程序固定到仪表盘，请右键点击 PyCharm 图标并选择 添加到收藏夹。

当您第一次运行 PyCharm 时，您可以采取几个步骤来完成安装，自定义您的实例，并开始使用该 IDE。

有关更多信息，请参见 首次运行 PyCharm。

有关默认 IDE 目录中用户特定文件位置的更多信息，请参阅 IDE 使用的目录。

在 Windows 上静默安装

静默安装在没有任何用户界面的情况下进行。 它可供网络管理员在多台机器上安装 PyCharm，并避免打断其他用户。

要执行静默安装，请使用以下更改运行安装程序：

  • /S ：启用静默安装

  • /CONFIG ：指定路径到 静默配置文件

  • /D ：指定安装目录的路径

    此参数必须在命令行中位于最后，即使路径包含空格，也不应包含任何引号。

  • /NCRC ：如果您想抑制 验证安装程序 弹出窗口，请禁用 CRC 检查。

例如：

pycharm.exe /S /CONFIG=d:\temp\silent.config /D=d:\IDE\PyCharm

在安装过程中检查问题时，请在 /LOG 开关中添加日志文件路径和名称，并将其置于 /S 和 /D 参数之间。 安装程序将生成指定的日志文件。 例如：

pycharm.exe /S /CONFIG=d:\temp\silent.config /LOG=d:\JetBrains\PyCharm\install.log /D=d:\IDE\PyCharm

静默配置文件

您可以在 https://download.jetbrains.com/python/silent.config 下载 PyCharm 的静默配置文件。

静默配置文件定义了安装PyCharm的选项。 默认选项下，静默安装仅为当前用户执行： mode=user。 如果您想为所有用户安装 PyCharm，请将安装模式选项的值更改为 mode=admin ，并以管理员身份运行安装程序。

默认静默配置文件对于每个 JetBrains 产品都是独一无二的。 您可以根据需要修改它，以启用或禁用各种安装选项。

有关安装 PyCharm 的更多详细信息，请参阅视频教程：

在 Linux 上作为 snap 包安装

您可以将 PyCharm 安装为一个独立的 snap 包。 由于 snaps 自动更新，您的 PyCharm 安装将始终保持最新。

要使用 snaps，请按照 snapd 安装指南 中的说明安装并运行 snapd 服务。

在 Ubuntu 16.04 LTS 及更高版本中，此服务已预安装。

PyCharm 通过两个渠道分发：

  • 稳定通道仅包含稳定版本。 要安装最新的 PyCharm 稳定版本，请运行以下命令：

    sudo snap install pycharm-professional --classic
    sudo snap install pycharm-community --classic

    PyCharm snap 需要像传统打包的应用程序一样，完全访问系统，因此需要 --classic 选项。

  • edge 渠道包含 EAP 版本。 要安装最新的 PyCharm EAP 版本，请运行以下命令：

    sudo snap install pycharm-professional --classic --edge
    sudo snap install pycharm-community --classic --edge

安装 snap 后，您可以通过运行 pycharm-professional 或 pycharm-community 命令来启动它。

要列出所有已安装的 snaps，请运行 sudo snap list。

安装指定版本

  1. 要检查可用版本的列表，请运行以下命令：

    snap info <pycharm-professional or·pycharm-community>

  2. 您想要安装的版本，请运行以下命令：

    sudo snap install <pycharm-professional or·pycharm-community> --channel=<version>/stable --classic

有关其他 snap 命令的更多信息，请参阅 Snapcraft 文档。

最后修改日期： 2025年 9月 26日
统一的 PyCharm 概览首次运行 PyCharm