PyCharm 2025.3 Help

安装 PyCharm

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

PyCharm 现已整合为一个统一的产品。

有哪些变更：

社区版现已成为统一的 PyCharm 产品的一部分：

  • PyCharm 的核心功能仍然免费且开源。

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

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

当您安装 PyCharm 时，您将自动获得 30 天的 Pro 免费试用，从而可完全访问 PyCharm 的高级功能。

试用结束后，您可以选择以下选项：

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

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

如果您已经在使用 PyCharm 专业版，您将凭现有许可证继续完全访问所有 Pro 功能——无需进行任何更改。

有关详细信息，请参阅 统一版 PyCharm 概述。

系统要求

要求

最低

推荐

RAM

2 GB 可用 RAM

8 GB 系统总 RAM

CPU

任何现代 CPU

多核 CPU。 PyCharm 支持针对不同操作和进程的多线程，所能利用的 CPU 核心越多，速度越快。

磁盘空间

3.5 GB

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

显示器分辨率

1024×768

1920×1080

操作系统

以下操作系统的正式发布版本：

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

    Windows Server 2019 64 位或更高版本

  • macOS 12.0 或更高版本

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

    • Linux 内核版本 6.x

    • Gnome 或 KDE 桌面环境

    • X Window System（X11）

    • GLIBC 2.28 或更高版本

不支持预发布版本。

以下项目的最新版本：

  • Windows 64 位

  • macOS

  • Ubuntu LTS 或 Fedora Linux 发行版

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

PyCharm 支持以下 Python 版本：

  • Python 2: 版本 2.7

  • Python 3: 从 3.9 版本到 3.14 版本

使用 Toolbox App 安装

JetBrains Toolbox App 是安装 JetBrains 产品的推荐工具。 使用它来安装和管理不同产品或同一产品的多个版本，包括 抢先体验计划 （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 网页 下载 tar 包 .tar.gz 。

  2. 解压该 tar 包并启动可执行文件：

    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 。

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

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

    在安装向导中注意以下选项：

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

    • 将文件夹作为项目打开 ：向文件夹上下文菜单添加一个选项，从而可以将所选目录作为 一个 PyCharm 项目打开。

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

    • 将启动器目录添加到 PATH ：允许在不指定路径的情况下从命令行运行此 PyCharm 实例。

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

  1. 下载磁盘映像.

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

  2. 挂载该映像，并将 PyCharm 应用拖动到 应用程序 文件夹。

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

使用 tar 归档安装

  1. 下载 tar 包

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

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

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

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

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

  3. 切换到 bin 子目录：

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

    例如，

    cd /opt/pycharm-2022.2.4/bin

  4. 从 bin 子目录运行 pycharm 。

    ./pycharm

创建桌面条目

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

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

  3. 点击 Dash 中的网格按钮以显示所有应用。

  4. 要将应用固定到 Dash，请右键点击 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

要检查安装过程中是否存在问题，请在 /S 与 /D 参数之间添加带有日志文件路径和名称的 /LOG 开关。 安装程序将生成指定的日志文件。 例如：

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 软件包。 由于 snap 会自动更新，您的 PyCharm 安装将始终保持最新。

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

在 Ubuntu 16.04 LTS 及更高版本上，该服务已预装。

PyCharm 通过两个渠道进行分发：

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

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

    --classic 选项是必需的，因为 PyCharm 的 snap 与传统打包的应用一样，需要对系统的完全访问权限。

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

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

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

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

安装特定版本

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

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

  2. 要安装所需版本，请运行以下命令：

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

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

最后修改日期： 2025年 12月 2日
统一版 PyCharm 概述首次运行 PyCharm