在 Linux 上安装 PyCharm 完整教程

PyCharm 是由 JetBrains 开发的功能强大的 Python IDE，在 Linux 上，你有多种方式来安装它，每种方式都有其优缺点。

使用 Snap 安装（最简单、推荐）

Snap 是一种软件包管理系统，由 Canonical 公司（Ubuntu 的母公司）开发，它最大的优点是自动处理依赖关系，并且能够将应用程序及其依赖项打包在一起，避免了版本冲突，几乎所有现代的 Linux 发行版（如 Ubuntu, Debian, Fedora, openSUSE, Manjaro 等）都支持 Snap。

优点：

• 极其简单：一条命令即可完成安装和更新。
• 依赖隔离：不会污染你的系统 Python 环境。
• 自动更新：后台会自动更新到最新稳定版。

缺点：

• 启动稍慢：因为需要解压和挂载文件系统。
• 占用空间稍大：包含了所有依赖。

安装步骤：

1. 打开终端 你可以使用 Ctrl + Alt + T 快捷键打开终端。

2. 安装 PyCharm 根据你的需求，选择安装社区版（免费）或专业版（付费）。

   • 安装 PyCharm 社区版 (免费)

     sudo snap install pycharm-community --classic

     --classic 参数允许 PyCharm 访问你的本地文件系统和网络等系统资源，这对于开发工作至关重要。

     
     （图片来源网络，侵删）

   • 安装 PyCharm 专业版 (付费，有免费试用)

     sudo snap install pycharm-professional --classic

3. 启动 PyCharm 安装完成后，你可以通过以下方式启动它：

   • 在终端中输入：

     pycharm-community
     # 或者
     pycharm-professional

   • 在应用程序菜单中找到 PyCharm 的图标并点击。

4. 更新 PyCharm 当有新版本时，Snap 会自动在后台下载，你可以手动触发更新：

   sudo snap refresh pycharm-community
   # 或者
   sudo snap refresh pycharm-professional

使用 JetBrains Toolbox App 安装（功能最全、推荐）

JetBrains 官方提供了一个名为 Toolbox App 的桌面应用程序，它是一个中心化的管理工具，可以让你轻松地安装、更新、降级以及管理 JetBrains 的所有 IDE（包括 PyCharm, IntelliJ IDEA, GoLand 等）。

优点：

• 一站式管理：所有 JetBrains IDE 都在一个 App 里管理。
• 轻松切换版本：可以轻松在不同版本的 PyCharm（如 2025.3 和 2025.1）之间切换。
• 自动更新：可以配置为自动更新或手动更新。
• 轻量级：它本身只是一个 App，不会像 Snap 那样影响整个系统。

缺点：

• 需要先安装一个管理工具,再通过它安装 PyCharm。

安装步骤：

1. 下载 Toolbox App 访问 JetBrains Toolbox App 的官方下载页面：https://www.jetbrains.com/toolbox-app/ 下载适用于 Linux 的 .tar.gz 压缩包。

2. 解压并运行 Toolbox App

   • 打开终端,进入你下载文件所在的目录（通常是 ~/Downloads）。
   • 使用以下命令解压（请将 X.Y.Z 替换为你下载的实际版本号）：

     cd ~/Downloads
     tar -xzf jetbrains-toolbox-X.Y.Z.tar.gz

   • 进入解压后的目录：

     cd jetbrains-toolbox-X.Y.Z/

   • 运行 jetbrains-toolbox：

     ./jetbrains-toolbox

     首次运行时,它会要求你同意许可协议，之后，它会打开一个图形化界面。

3. 通过 Toolbox App 安装 PyCharm

   • 在 Toolbox App 的窗口中，你会看到所有可安装的 JetBrains 产品列表。
   • 找到 PyCharm。
   • 在 PyCharm Community 或 PyCharm Professional 的卡片上，点击 Install 按钮。
   • 你可以选择安装路径,但通常使用默认路径即可。

4. 启动和更新

   • 安装完成后,Toolbox App 会显示一个“已安装”的标签页，并提供了快捷启动按钮。
   • 更新非常简单：在 Toolbox App 中，点击已安装的 PyCharm 旁边的 (更多) 按钮，选择 Update 或 Check for Updates。

手动下载 .tar.gz 安装包（不推荐新手）

这种方式最灵活,但也最麻烦，需要手动处理依赖和卸载。除非你的系统非常老旧，不支持 Snap 或 AppImage，否则不推荐使用此方法。

安装步骤：

1. 下载 .tar.gz 包 访问 PyCharm 官方下载页面：https://www.jetbrains.com/pycharm/download/ 选择 "Linux" 选项卡，下载 .tar.gz 版本。

2. 解压

   # 进入下载目录
   cd ~/Downloads
   # 解压文件 (将 PyCharm-... 替换为你的文件名)
   tar -xzf PyCharm-*.tar.gz
   # 移动到一个合适的位置，/opt/
   sudo mv PyCharm-* /opt/pycharm

3. 创建桌面快捷方式 为了方便启动，最好创建一个 .desktop 文件。

   sudo nano /usr/share/applications/pycharm.desktop

   在打开的文件中,粘贴以下内容（请务必修改 Exec 和 Icon 路径为你实际的安装路径）：

   [Desktop Entry]
   Version=1.0
   Type=Application
   Name=PyCharm
   Icon=/opt/pycharm/bin/pycharm.png  # 修改为你的图标路径
   Exec="/opt/pycharm/bin/pycharm.sh" %f  # 修改为你的启动脚本路径
   Comment=A powerful Python IDE
   Categories=Development;IDE;
   Terminal=false
   StartupNotify=true
   StartupWMClass=jetbrains-pycharm-ce  # 如果是专业版，这里是 jetbrains-pycharm

   保存并退出（在 nano 中是 Ctrl+X，Y，Enter）。

4. 启动 现在你可以从应用程序菜单中找到 PyCharm 并启动它。

常见问题与解决方案

Q1: 启动 PyCharm 时提示 "Failed to create JVM" 或 "Error: JVM not found"

这通常意味着你的系统上没有安装 Java 运行时环境，PyCharm 是一个 Java 应用程序，需要 JVM 来运行。

解决方案： 大多数现代 Linux 发行版默认不安装 Java，你需要安装 OpenJDK。

• 在 Debian/Ubuntu/Mint 上:

  sudo apt update
  sudo apt install openjdk-11-jdk openjdk-11-jre

  或者安装最新的 LTS 版本（如 17 或 21）。

• 在 Fedora/CentOS/RHEL 上:

  sudo dnf install java-11-openjdk-devel java-11-openjdk

安装完成后,重启 PyCharm 即可。

Q2: 启动器图标不显示，或者无法从菜单启动

这通常是因为 .desktop 文件没有正确的执行权限，或者 Exec/Icon 路径错误。

解决方案： 如果你使用了手动安装方式，请确保 .desktop 文件中的路径是正确的，然后执行以下命令：

sudo chmod +x /usr/share/applications/pycharm.desktop
update-desktop-database /usr/share/applications

Q3: 如何卸载 PyCharm？

• 如果你使用 Snap 安装:

  sudo snap remove pycharm-community  # 或 pycharm-professional

• 如果你使用 Toolbox App 安装: 只需在 Toolbox App 中找到 PyCharm，点击 ⋮ 按钮，然后选择 Uninstall 即可。

• 如果你使用手动 .tar.gz 安装: 只需删除你之前移动的文件夹：

  sudo rm -rf /opt/pycharm

  并且最好也删除之前创建的 .desktop 文件：

  sudo rm /usr/share/applications/pycharm.desktop

总结与建议

对于绝大多数 Linux 用户，首选 Snap 安装，因为它最省心，如果你是 JetBrains 的重度用户，Toolbox App 是更好的选择，希望这份教程对你有帮助！