在 Ubuntu 系统上安装 PyCharm – wiki基地


在 Ubuntu 系统上安装强大的 Python IDE – PyCharm 详解

Ubuntu,作为最受欢迎的 Linux 发行版之一,为开发者提供了一个稳定、开放且功能丰富的环境。而 PyCharm,由 JetBrains 公司开发的 Python 集成开发环境(IDE),以其强大的代码编辑、调试、测试和项目管理功能,成为了 Python 开发者的首选工具之一。将 PyCharm 安装在 Ubuntu 系统上,能够极大地提升 Python 开发的效率和体验。

本文将为您详细介绍在 Ubuntu 系统上安装 PyCharm 的多种方法,包括使用 Snap 包管理器、使用 JetBrains 官方 Toolbox App,以及手动下载和安装官方压缩包。我们将深入探讨每种方法的优缺点,并提供详细的步骤指导,确保您能够顺利地在您的 Ubuntu 系统上配置好 PyCharm 开发环境。

1. 为什么选择 PyCharm? PyCharm 的优势概述

在开始安装之前,让我们快速回顾一下为什么 PyCharm 是一个值得选择的 Python IDE:

  • 智能代码编辑器: 提供了语法高亮、代码补全(包括智能感知、类型提示)、代码检查和快速修复、代码重构等高级功能,显著提高编码速度和质量。
  • 强大的调试器: 允许您设置断点、单步执行代码、检查变量值、评估表达式,帮助您快速定位和解决程序中的错误。
  • 集成的开发工具: 内置了对版本控制系统(Git, Mercurial, SVN 等)、数据库工具、科学计算工具(如 NumPy, SciPy, Matplotlib)的良好支持。
  • 虚拟环境管理: 方便地创建、配置和切换 Python 虚拟环境(venv, virtualenv, Conda),确保项目依赖的隔离和管理。
  • Web 开发支持: 对 Django, Flask, Pyramid 等 Web 框架提供了深度支持,包括模板语言、ORM 的代码智能提示。
  • 单元测试集成: 能够方便地运行和管理各种测试框架(如 unittest, pytest, nose)。
  • 项目和代码导航: 强大的搜索和导航功能,让您轻松浏览大型项目中的代码。
  • 丰富的插件生态系统: 可以通过安装插件扩展 IDE 的功能,满足特定需求。

PyCharm 提供两个主要版本:

  • PyCharm Community Edition (社区版): 免费开源,提供了核心的 Python 开发功能,适用于纯 Python 开发。
  • PyCharm Professional Edition (专业版): 付费版本,在社区版的基础上增加了对 Web 开发框架、科学计算工具、数据库、远程开发等更广泛的支持。

了解了 PyCharm 的优势后,我们就可以根据您的需求和偏好选择合适的安装方法了。

2. 安装前的准备工作

在开始安装 PyCharm 之前,请确保您的 Ubuntu 系统满足以下基本要求:

  • Ubuntu 系统: 本文以较新的 Ubuntu 版本(如 20.04 LTS, 22.04 LTS 或更高版本)为例进行说明。
  • 稳定的互联网连接: 安装过程需要下载 PyCharm 安装包。
  • 足够的磁盘空间: PyCharm 安装及运行需要一定的存储空间,建议至少预留几个 GB。
  • Java 环境: 虽然 JetBrains IDE 捆绑了自己的 Java 运行时环境(JRE),但在某些情况下(尤其是旧版本或特定配置),您可能需要一个兼容的 Java 开发工具包(JDK)。不过对于新版本的 PyCharm,通常无需单独安装 JDK。
  • 终端访问权限: 您需要使用终端执行一些命令。

请注意,PyCharm 的具体系统要求可能会随版本更新而变化,建议查阅 JetBrains 官方网站上对应版本的 PyCharm 系统要求页面以获取最新信息。

3. 方法一:使用 Snap 包管理器安装 (推荐简单易用)

Snap 是由 Canonical(Ubuntu 的开发者)推出的一种软件包管理和分发系统。它允许开发者将应用程序及其所有依赖项打包到一个独立的单元中。Snap 的优点在于易于安装、易于更新,并且应用程序通常运行在沙盒环境中,与其他系统文件隔离,提高了安全性。对于大多数 Ubuntu 用户来说,使用 Snap 安装 PyCharm 是最简单、最推荐的方法。

步骤详解:

  1. 打开终端: 您可以通过在应用菜单中搜索 “Terminal” 或使用快捷键 Ctrl + Alt + T 来打开终端。

  2. 搜索 PyCharm Snap 包: 在终端中输入以下命令来搜索 PyCharm 的可用版本。通常会有 pycharm-communitypycharm-professional

    bash
    snap find pycharm

    执行该命令后,您会看到一个列表,显示 PyCharm 的不同版本和通道(如 stable, edge)。

    Name Version Publisher Notes Summary
    pycharm-community 2023.2.1 jetbrains* classic PyCharm Community Edition
    pycharm-professional 2023.2.1 jetbrains* classic PyCharm Professional Edition
    pycharm-educational 2023.2.1 jetbrains* classic PyCharm Educational Edition
    ...

    注意 Publisherjetbrains*,这表示这是由 JetBrains 官方发布的包,是可靠的来源。Notes 列的 classic 表示这是一个经典的 Snap 包,它不像严格限制的 Snap 包那样运行在严格的沙盒中,这是因为 IDE 需要访问文件系统和系统资源。

  3. 安装 PyCharm Community Edition (社区版): 如果您想安装免费的社区版,使用以下命令:

    bash
    sudo snap install pycharm-community --classic

    • sudo: 这是因为安装 Snap 包需要管理员权限。
    • snap install: 这是安装 Snap 包的命令。
    • pycharm-community: 这是您要安装的软件包的名称。
    • --classic: 非常重要! PyCharm 作为一个功能全面的 IDE,需要访问系统上的文件和资源(如您的项目文件、Python 解释器等),因此不能运行在严格隔离的沙盒中。--classic 标志允许 Snap 包以经典的(非严格沙盒)方式安装,赋予它更广泛的系统访问权限,这对于 IDE 来说是必需的。
  4. 安装 PyCharm Professional Edition (专业版): 如果您拥有专业版的许可证或想试用专业版,使用以下命令:

    bash
    sudo snap install pycharm-professional --classic

    同样,请务必加上 --classic 标志。

  5. 等待安装完成: Snap 包管理器会下载并安装 PyCharm。这可能需要一些时间,具体取决于您的网速。安装过程中,您会看到下载和安装的进度信息。

  6. 启动 PyCharm: 安装完成后,您可以通过以下方式启动 PyCharm:

    • 通过应用菜单: 打开 Ubuntu 的应用菜单(通常在左下角),搜索 “PyCharm”,然后点击对应的图标(Community 或 Professional)。
    • 通过终端: 在终端中输入相应的命令。对于社区版是 pycharm-community,对于专业版是 pycharm-professional

    bash
    pycharm-community # 启动社区版


    bash
    pycharm-professional # 启动专业版

Snap 安装方法的优点:

  • 简单方便: 只需一个命令即可完成安装。
  • 自动更新: Snap 包会定期自动在后台更新到最新版本,无需手动干预。
  • 官方支持: JetBrains 官方维护并发布 PyCharm 的 Snap 包,确保了可靠性。
  • 易于卸载: 卸载也非常简单。

Snap 安装方法的缺点:

  • 启动速度: 有时 Snap 应用的首次启动可能会比原生安装的应用稍慢。
  • 磁盘空间: Snap 包通常比传统的 DEB 包占用更多磁盘空间,因为它们包含了所有依赖。
  • 经典限制: 需要使用 --classic 标志,这意味着它不像严格沙盒应用那样提供完全的隔离安全。

卸载 Snap 安装的 PyCharm:

如果您需要卸载 PyCharm(例如切换到其他安装方式),只需在终端中执行以下命令:

bash
sudo snap remove pycharm-community # 卸载社区版


bash
sudo snap remove pycharm-professional # 卸载专业版

4. 方法二:使用 JetBrains Toolbox App 安装 (推荐管理多个 JetBrains 产品)

JetBrains Toolbox App 是 JetBrains 官方提供的一款工具,用于管理您安装的所有 JetBrains IDE(包括 IntelliJ IDEA, WebStorm, DataGrip 等)和 PyCharm。使用 Toolbox App 的优势在于,您可以轻松安装不同版本的 IDE,并在它们之间切换,更新和回滚版本,以及集中管理您的 JetBrains 帐户和许可证。

步骤详解:

  1. 下载 JetBrains Toolbox App:

    • 打开您的网络浏览器,访问 JetBrains 官方网站的 Toolbox App 下载页面。您可以通过搜索引擎搜索 “JetBrains Toolbox App”。
    • 找到 Linux 版本的下载链接,通常是一个 .tar.gz 压缩包。点击下载。
  2. 打开终端: 使用 Ctrl + Alt + T 打开终端。

  3. 切换到下载目录: 进入您下载 Toolbox App 压缩包的目录,通常是 ~/Downloads

    bash
    cd ~/Downloads

  4. 解压 Toolbox App 压缩包: 使用 tar 命令解压下载的文件。请将 [版本号] 替换为您下载的实际文件名中的版本号。

    bash
    tar -xzf jetbrains-toolbox-*.tar.gz

    例如,如果文件名是 jetbrains-toolbox-2.0.0.16462.tar.gz,命令就是 tar -xzf jetbrains-toolbox-2.0.0.16462.tar.gz。或者使用通配符 jetbrains-toolbox-*.tar.gz 来匹配任何版本号。

    解压后会创建一个名为 jetbrains-toolbox-[版本号] 的目录。

  5. 运行 Toolbox App: 进入解压后的目录,并运行里面的 jetbrains-toolbox 可执行文件。

    bash
    cd jetbrains-toolbox-*/
    ./jetbrains-toolbox

    第一次运行可能需要接受用户协议。接受后,Toolbox App 的窗口就会出现。Toolbox App 默认会安装到您的用户主目录下的 .local/share/JetBrains/Toolbox 目录中。

  6. 使用 Toolbox App 安装 PyCharm:

    • 在 Toolbox App 窗口中,您会看到 JetBrains 的产品列表。
    • 向下滚动找到 PyCharm Community Edition 和 PyCharm Professional Edition。
    • 点击您想要安装的 PyCharm 版本旁边的 “Install” 按钮。您可以选择安装最新稳定版,也可以点击版本号旁边的下拉箭头选择其他版本。
  7. 等待安装完成: Toolbox App 会下载并安装 PyCharm 到您用户目录下的指定位置。这过程会显示进度条。

  8. 启动 PyCharm: 安装完成后,Toolbox App 中 PyCharm 的 “Install” 按钮会变成 “Open”。点击 “Open” 即可启动 PyCharm。Toolbox App 还会自动在您的应用菜单中创建 PyCharm 的快捷方式。

Toolbox App 安装方法的优点:

  • 集中管理: 可以轻松管理所有 JetBrains IDE 的安装、更新和卸载。
  • 多版本支持: 方便安装和切换同一 IDE 的不同版本。
  • 智能更新: 可以方便地更新到最新版本,甚至回滚到旧版本。
  • 无须管理员权限: Toolbox App 及其安装的 IDE 通常安装在用户主目录下,无需 sudo 权限(Toolbox App 首次运行时可能需要少量权限来设置桌面快捷方式等,但 IDE 安装本身不需要)。

Toolbox App 安装方法的缺点:

  • 额外一层管理工具: 需要先下载、安装并运行 Toolbox App 本身。
  • 磁盘空间: 安装的 IDE 仍然会占用一定的磁盘空间,但与 Snap 相比,它可以更容易地管理不同版本的占用。

卸载通过 Toolbox App 安装的 PyCharm:

要卸载 PyCharm,只需打开 Toolbox App,找到对应的 PyCharm 版本,点击旁边的三个点菜单,然后选择 “Uninstall”。Toolbox App 会负责清理相关文件。要卸载 Toolbox App 本身,删除其安装目录 (~/.local/share/JetBrains/Toolbox) 和相关的配置文件即可。

5. 方法三:手动下载 Tar.gz 压缩包安装 (提供最大灵活性)

手动下载 JetBrains 官方网站提供的 .tar.gz 压缩包进行安装,是另一种常见的方法。这种方法可以让您完全控制安装位置和过程,适用于需要特定安装路径、离线安装或希望更深入了解安装细节的用户。

步骤详解:

  1. 下载 PyCharm 压缩包:

    • 打开您的网络浏览器,访问 PyCharm 的官方下载页面(jetbrains.com/pycharm/download/)。
    • 找到 Linux 版本下载区域。选择您想要安装的版本(Community 或 Professional)。
    • 确保选择 .tar.gz 格式的下载链接。点击下载。
  2. 打开终端: 使用 Ctrl + Alt + T 打开终端。

  3. 切换到下载目录: 进入您下载 PyCharm 压缩包的目录,通常是 ~/Downloads

    bash
    cd ~/Downloads

  4. 选择安装目录: 选择一个合适的目录来安装 PyCharm。推荐的系统级安装位置是 /opt 目录。将 PyCharm 安装到 /opt 需要管理员权限,但好处是它是一个标准的存放非系统必要软件的目录,且安装位置明确。您也可以选择安装到用户主目录下的某个位置(例如 ~/Applications),这样无需 sudo 权限,但可能不符合 FHS(文件系统层次结构标准)。

    我们以安装到 /opt 为例进行说明。

  5. 解压压缩包到安装目录: 使用 tar 命令将下载的压缩包解压到您选择的安装目录。您需要使用 sudo 因为目标目录 /opt 通常需要管理员权限写入。请将 [版本号] 替换为您下载的实际文件名中的版本号,并将 [安装目录] 替换为您选择的目标目录(例如 /opt/).

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


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

    • sudo: 获取管理员权限。
    • tar: 解压命令。
    • -xzf: 解压(x),处理 gzip 压缩(z),指定输入文件(f)。
    • pycharm-*-*.tar.gz: 下载的压缩包文件名(使用通配符匹配版本号)。
    • -C /opt/: 指定解压目标目录为 /opt/

    解压完成后,/opt/ 目录下会出现一个名为 pycharm-community-[版本号]pycharm-professional-[版本号] 的新目录。

  6. 切换到 PyCharm 安装目录: 进入刚刚解压出来的 PyCharm 目录的 bin 子目录。

    bash
    cd /opt/pycharm-community-*/bin/


    bash
    cd /opt/pycharm-professional-*/bin/

  7. 运行 PyCharm:bin 目录中,执行 pycharm.sh 脚本来启动 PyCharm。

    bash
    ./pycharm.sh

    第一次运行可能会提示您导入设置、接受用户协议等,这与其他安装方法类似。

  8. 创建桌面快捷方式 (重要!): 每次都通过终端进入 bin 目录并运行 ./pycharm.sh 非常不便。为了能够从应用菜单中启动 PyCharm,您需要手动创建一个 .desktop 文件。

    当您第一次通过 ./pycharm.sh 脚本启动 PyCharm 后,PyCharm 会提供一个选项来创建桌面入口。通常,您可以在启动向导的欢迎屏幕或通过菜单 Tools -> Create Desktop Entry... 找到这个选项。勾选 “Create for all users” 如果您希望所有用户都能看到快捷方式(这可能需要 sudo 权限),否则只为您当前用户创建即可。PyCharm 会自动完成这个过程。

    如果自动创建失败或您想手动创建,可以按照以下步骤:

    • 打开一个新的终端。
    • 使用文本编辑器创建一个新的 .desktop 文件。对于当前用户,文件应保存在 ~/.local/share/applications/ 目录下。文件名为 jetbrains-pycharm-community.desktopjetbrains-pycharm-professional.desktop

      bash
      nano ~/.local/share/applications/jetbrains-pycharm-community.desktop


      bash
      nano ~/.local/share/applications/jetbrains-pycharm-professional.desktop

    • 将以下内容粘贴到文件中。请根据您的 PyCharm 版本和实际安装路径修改 ExecIcon 行中的路径。假设您安装在 /opt/pycharm-community-2023.2.1

      对于社区版:

      ini
      [Desktop Entry]
      Version=1.0
      Type=Application
      Name=PyCharm Community Edition
      Icon=/opt/pycharm-community-2023.2.1/bin/pycharm.svg
      Exec="/opt/pycharm-community-2023.2.1/bin/pycharm.sh" %f
      Comment=Python IDE for Professional Developers
      Categories=Development;IDE;
      Terminal=false
      StartupWMClass=jetbrains-pycharm-ce

      对于专业版:

      ini
      [Desktop Entry]
      Version=1.0
      Type=Application
      Name=PyCharm Professional Edition
      Icon=/opt/pycharm-professional-2023.2.1/bin/pycharm.svg
      Exec="/opt/pycharm-professional-2023.2.1/bin/pycharm.sh" %f
      Comment=Python IDE for Professional Developers
      Categories=Development;IDE;
      Terminal=false
      StartupWMClass=jetbrains-pycharm

      • 重要:/opt/pycharm-community-2023.2.1/opt/pycharm-professional-2023.2.1 替换为您实际的安装路径。
      • Icon 行指定了应用图标的路径。
      • Exec 行指定了执行文件,%f 表示如果从文件管理器中打开一个文件,会将其路径作为参数传递给 PyCharm。
      • StartupWMClass 有助于窗口管理器识别应用程序的窗口。
    • 保存并关闭文件 (在 nano 中,按 Ctrl + X, 然后 Y, 最后回车)。

    • 更新桌面文件缓存(有时需要注销并重新登录才能看到新图标,但有时执行以下命令即可):

      bash
      sudo desktop-file-install ~/.local/share/applications/jetbrains-pycharm-community.desktop # 替换为您的文件名
      sudo update-desktop-database

    现在,您应该能够在应用菜单中找到并启动 PyCharm 了。

  9. 将 PyCharm 加入到 PATH (可选): 如果您想在任何终端窗口中直接输入 pycharm.sh 命令来启动 PyCharm(而不是进入其 bin 目录),可以将 PyCharm 的 bin 目录添加到系统的 PATH 环境变量中。

    • 打开您的 shell 配置文件,通常是 ~/.bashrc (如果您使用 Bash) 或 ~/.zshrc (如果您使用 Zsh)。

      bash
      nano ~/.bashrc

    • 在文件末尾添加以下行,将 /opt/pycharm-community-2023.2.1/bin 替换为您实际的 PyCharm bin 目录路径。

      bash
      export PATH="$PATH:/opt/pycharm-community-2023.2.1/bin"

    • 保存并关闭文件。

    • 在当前终端会话中使更改生效:

      bash
      source ~/.bashrc

      或者关闭并重新打开终端。

    现在,您应该可以直接在终端中输入 pycharm.sh 并回车来启动 PyCharm 了。

手动 Tar.gz 安装方法的优点:

  • 完全控制: 可以自由选择安装位置。
  • 离线安装: 下载一次压缩包可以在没有网络的环境下安装。
  • 多版本并行: 可以轻松解压多个版本的 PyCharm 到不同目录并使用。
  • 更快的启动速度: 通常比 Snap 应用启动更快。

手动 Tar.gz 安装方法的缺点:

  • 更新不便: 更新 PyCharm 通常需要手动下载新版本,解压替换旧版本,并可能需要重新创建或更新桌面入口和 PATH 设置。没有自动更新功能。
  • 需要手动配置: 需要手动创建桌面入口和添加到 PATH(如果需要)。
  • 需要管理员权限: 如果安装到系统目录(如 /opt),需要使用 sudo
  • 卸载需要手动删除: 需要手动删除安装目录和相关的快捷方式/PATH 配置。

卸载手动安装的 PyCharm:

  1. 删除安装目录:

    bash
    sudo rm -rf /opt/pycharm-community-2023.2.1 # 替换为您的实际安装路径


    bash
    sudo rm -rf /opt/pycharm-professional-2023.2.1 # 替换为您的实际安装路径

  2. 删除桌面快捷方式文件:

    bash
    rm ~/.local/share/applications/jetbrains-pycharm-community.desktop # 替换为您的文件名


    bash
    rm ~/.local/share/applications/jetbrains-pycharm-professional.desktop # 替换为您的文件名

  3. 从 PATH 中移除 (如果已添加): 编辑您的 shell 配置文件 (~/.bashrc~/.zshrc),删除或注释掉您之前添加的 export PATH=... 那一行,然后 source 文件或重新打开终端。

6. PyCharm 首次启动及基础配置

无论您使用哪种方法安装 PyCharm,首次启动时都会经历一个相似的配置过程。

  1. 用户协议 (User Agreement): 阅读并接受 JetBrains 用户协议。
  2. 数据共享 (Data Sharing): 选择是否向 JetBrains 发送匿名使用数据。您可以选择 “Send Usage Statistics” 或 “Don’t Send”。
  3. 导入设置 (Import Settings): 如果您之前安装过 PyCharm 或其他 JetBrains IDE 并导出了设置,可以选择导入。否则选择 “Do not import settings”。
  4. UI 主题 (UI Theme): 选择您喜欢的用户界面主题,如 Darcula (深色主题) 或 Light (浅色主题)。您可以在后续随时更改。
  5. 启动器脚本 (Launcher Script) / 桌面入口 (Desktop Entry): 对于手动安装,这时可能会提示您创建启动器脚本或桌面入口。对于 Snap 或 Toolbox 安装,这一步可能不会出现或已经完成。建议创建以便从终端或应用菜单方便启动。
  6. 功能定制 (Customize features): (仅限专业版) 您可以选择安装或禁用某些插件和功能,例如对特定框架(Django, Flask 等)、数据库、版本控制等的支持。如果您不确定,可以保留默认设置。
  7. 授权 (Activation):
    • Community Edition: 这是免费的,直接进入下一步即可开始使用。
    • Professional Edition: 您需要激活 PyCharm。您可以选择:
      • Log In to JetBrains Account: 如果您购买了许可证,可以使用您的 JetBrains 账户登录进行激活。
      • Activation code: 输入您收到的激活码。
      • License server: 连接到您组织的许可证服务器。
      • Start free trial: 如果您是首次使用专业版,可以选择开始免费试用期。

完成这些步骤后,您就会进入 PyCharm 的欢迎界面,可以开始创建新项目、打开现有项目或学习 PyCharm 的基本用法了。

7. PyCharm 的更新与卸载管理

  • Snap 安装: Snap 包管理器会定期检查并自动更新已安装的 PyCharm 到最新的稳定版本。您无需手动干预。要手动触发更新检查,可以使用 sudo snap refresh pycharm-communitysudo snap refresh pycharm-professional。卸载命令如前所述:sudo snap remove pycharm-communitysudo snap remove pycharm-professional
  • Toolbox App 安装: Toolbox App 是管理更新的最佳方式。打开 Toolbox App,它会自动检查所有已安装 IDE 的更新。在 PyCharm 条目旁边,如果发现新版本,会显示 “Update” 按钮。点击即可轻松更新。您甚至可以选择安装特定版本或回滚到旧版本。卸载也非常简单,直接在 Toolbox App 中操作即可。
  • 手动 Tar.gz 安装: 更新通常意味着下载新版本的 .tar.gz 文件,并将其解压到新的目录。您可以保留旧版本,或在确认新版本正常工作后删除旧版本。更新时,您可能需要重新创建桌面入口或修改 PATH 环境变量以指向新版本。卸载需要手动删除安装目录和相关配置文件/快捷方式。

8. 总结与选择建议

本文详细介绍了在 Ubuntu 系统上安装 PyCharm 的三种主要方法:Snap、Toolbox App 和手动 Tar.gz 安装。每种方法都有其适用的场景和优缺点:

  • Snap (推荐大多数用户): 最简单方便,适合希望快速安装、自动更新且不介意 Snap 包管理的用户。无需担心依赖问题。
  • Toolbox App (推荐管理多个 JetBrains 产品): 如果您使用 JetBrains 的其他 IDE,或者需要频繁安装、切换、更新和管理不同版本的 PyCharm,Toolbox App 是最佳选择。提供了最灵活的版本管理。
  • 手动 Tar.gz (推荐需要完全控制安装位置或离线安装的用户): 提供对安装过程和位置的最大控制权,启动速度通常最快。但更新和卸载需要更多手动操作。

对于刚接触 PyCharm 或 Ubuntu 的用户,Snap 安装通常是最省心的选择。如果您是 JetBrains 的重度用户,Toolbox App 将是您不可或缺的工具。如果您有特定的需求(如安装到非标准位置或离线部署),手动安装则提供了必要的灵活性。

希望这篇详细的文章能帮助您成功地在 Ubuntu 系统上安装并配置好 PyCharm,开启您高效愉快的 Python 开发之旅!祝您编码愉快!


发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部