PyCharm 在 Linux 上的安装指南

前言

文章目录

前言
- 第一部分：安装前的准备
- - [1.1 系统要求](#1.1 系统要求)
  - [1.2 检查 Java 环境](#1.2 检查 Java 环境)
  - [1.3 选择 PyCharm 版本](#1.3 选择 PyCharm 版本)
- [第二部分：安装 PyCharm](#第二部分：安装 PyCharm)
- - [2.1 方法一：使用 Snap 包安装（最简单）](#2.1 方法一：使用 Snap 包安装（最简单）)
  - [2.2 方法二：使用 Tar.gz 压缩包安装（最灵活）](#2.2 方法二：使用 Tar.gz 压缩包安装（最灵活）)
  - [2.3 方法三：使用 JetBrains Toolbox App（官方推荐）](#2.3 方法三：使用 JetBrains Toolbox App（官方推荐）)
- 第三部分：首次运行与初始配置
- - [3.1 导入设置](#3.1 导入设置)
  - [3.2 许可协议](#3.2 许可协议)
  - [3.3 UI 主题选择](#3.3 UI 主题选择)
  - [3.4 自定义插件](#3.4 自定义插件)
  - [3.5 创建启动器脚本](#3.5 创建启动器脚本)
- 第四部分：核心功能与使用详解
- - [4.1 创建和管理项目](#4.1 创建和管理项目)
  - [4.2 用户界面导览](#4.2 用户界面导览)
  - [4.3 智能代码编辑](#4.3 智能代码编辑)
  - [4.4 强大的调试器](#4.4 强大的调试器)
  - [4.5 测试集成](#4.5 测试集成)
  - [4.6 版本控制集成 (Git)](#4.6 版本控制集成 (Git))
- 第五部分：高级配置与技巧
- - [5.1 配置 Python 解释器](#5.1 配置 Python 解释器)
  - [5.2 调整外观和键映射](#5.2 调整外观和键映射)
  - [5.3 安装与配置插件](#5.3 安装与配置插件)
  - [5.4 使用远程解释器进行远程开发](#5.4 使用远程解释器进行远程开发)
- 第六部分：故障排除与性能优化
- - [6.1 常见问题](#6.1 常见问题)
  - [6.2 性能优化](#6.2 性能优化)
- 结论
- 引用与资源出处

PyCharm 是由 JetBrains 开发的一款功能强大的 Python 集成开发环境（IDE），被广大 Python 开发者誉为"Python 开发神器"。它提供了智能代码补全、实时错误检查、强大的调试器、集成单元测试、版本控制集成等一系列高效开发工具，极大地提升了 Python 项目的开发效率和质量。Linux 系统，以其高度的可定制性和稳定性，成为众多开发者的首选操作系统。将 PyCharm 运行在 Linux 上，能够充分发挥两者优势，构建一个极其流畅和高效的开发工作流。

本指南旨在为 Linux 用户提供一份从零开始，涵盖 PyCharm 的安装、配置、核心功能使用到高级技巧的万字详尽教程。无论你是刚接触 Linux 和 PyCharm 的新手，还是希望深化理解、提升工作效率的老手，本文都将为你提供有价值的参考。

第一部分：安装前的准备

1.1 系统要求

在开始安装之前，请确保您的 Linux 系统满足 PyCharm 的最低要求：

内存：至少 4 GB RAM，建议 8 GB 或以上。
磁盘空间：至少 2.5 GB 空闲空间，另外还需为项目预留空间。
显示器：1024x768 最低分辨率。
Java 运行时环境 (JRE)：PyCharm 基于 Java 开发，需要 JRE 1.8 或更高版本。大多数现代 Linux 发行版已预装 OpenJDK，但建议检查并确认。

1.2 检查 Java 环境

打开终端，运行以下命令来检查 Java 是否已安装：

bash 复制代码

java -version

如果系统返回了类似 openjdk version "11.0.20" 2023-07-18 的版本信息，说明已安装。如果未安装，您可以使用包管理器安装 OpenJDK。

在 Ubuntu/Debian 上：

bash 复制代码

sudo apt update
sudo apt install openjdk-11-jdk  # 或者 openjdk-17-jdk, openjdk-18-jdk 等

在 Fedora/RHEL/CentOS 上：

bash 复制代码

sudo dnf install java-11-openjdk-devel  # 或者使用 yum

1.3 选择 PyCharm 版本

PyCharm 提供两个版本：

专业版 (Professional)：功能全面，支持 Web 开发（Django, Flask）、科学计算（DataSpell）、数据库、远程开发等高级功能。需要付费订阅，但提供 30 天免费试用。
社区版 (Community)：免费开源，提供基本的 Python 开发功能，包括代码补全、调试器、集成单元测试、版本控制集成等。对于纯 Python 开发和学习来说完全足够。

请根据您的需求选择版本。本教程将主要以专业版的界面进行演示，但大部分基础功能在两个版本中通用。

第二部分：安装 PyCharm

在 Linux 上，有多种安装 PyCharm 的方法，我们将介绍最常用的三种。

2.1 方法一：使用 Snap 包安装（最简单）

Snap 是一种通用的 Linux 软件包格式，简化了安装和更新过程。许多现代 Linux 发行版（如 Ubuntu）都预装了 Snap。

打开终端，运行以下命令即可安装 PyCharm 专业版：

bash 复制代码

sudo snap install pycharm-professional --classic

要安装社区版，请使用：

bash 复制代码

sudo snap install pycharm-community --classic

--classic 参数是因为 Snap 通常将应用限制在沙盒中，但 PyCharm 需要访问系统资源（如文件系统、外部工具），因此需要经典 confinement 模式。

优点：自动更新，依赖项自动管理。
缺点：启动速度可能稍慢，且版本更新可能略滞后于官方渠道。

2.2 方法二：使用 Tar.gz 压缩包安装（最灵活）

这是 JetBrains 官方推荐的方式，可以直接从官网获取最新版本，并允许用户完全控制安装位置和配置。

步骤 1：下载 Tar.gz 包

访问 JetBrains PyCharm 下载页面。根据你的需求选择"Professional"或"Community"版本，下载 .tar.gz 格式的压缩包。

步骤 2：解压缩

通常，我们将 IDE 解压到 /opt 目录，这是一个存放第三方应用程序的标准位置。

bash 复制代码

# 将下载的压缩包移动到 /opt (可选，也可以在其他位置解压)
sudo tar -xzf pycharm-*.tar.gz -C /opt/

步骤 3：运行 PyCharm

进入解压后的 bin 目录，执行启动脚本。

bash 复制代码

cd /opt/pycharm-2023.2.1/bin  # 请将目录名替换为你下载的实际版本
./pycharm.sh

首次运行会进行一系列初始化设置。

步骤 4：创建桌面快捷方式（可选）

为了让启动更方便，可以创建桌面入口。PyCharm 首次启动时通常会提示你创建桌面条目。如果错过了，可以手动操作：

在 PyCharm 中，点击菜单栏 Tools -> Create Desktop Entry...。
勾选 Create the entry for all users (需要 root 权限) 或仅当前用户。
之后，你就可以在系统应用菜单中找到 PyCharm 了。

优点：版本控制灵活，可以同时安装多个版本，无沙盒限制性能更好。
缺点：需要手动更新。

2.3 方法三：使用 JetBrains Toolbox App（官方推荐）

Toolbox App 是管理所有 JetBrains IDE 的最佳方式。它可以轻松安装、更新和切换不同版本和不同系列的 IDE。

步骤 1：下载并安装 Toolbox App

访问 Toolbox App 官网下载 .tar.gz 包。
解压并运行其中的 jetbrains-toolbox 可执行文件。
它会自动安装到你的用户目录（如 ~/.local/share/JetBrains/Toolbox/bin）并提示你创建桌面入口。

步骤 2：安装 PyCharm

打开 Toolbox App。
在列表中找到 PyCharm，点击安装。
选择版本（稳定版 vs 早期访问计划版）和安装路径（默认为 ~/.local/share/JetBrains/Toolbox/apps/PYCHARM）。

Toolbox App 会自动为你创建启动器脚本和桌面条目。

优点：无缝更新和管理，轻松降级或尝试预览版，清理旧版本。
缺点：需要运行一个额外的后台应用。

第三部分：首次运行与初始配置

首次启动 PyCharm 会引导你进行一些重要配置。

3.1 导入设置

如果你是首次安装，选择 Do not import settings。如果是从旧版本升级或迁移，可以导入之前的配置。

3.2 许可协议

阅读并接受用户协议。对于专业版，你可以选择试用（Start trial）或输入激活码（Activate）。

3.3 UI 主题选择

选择你喜欢的 UI 主题（Darcula 深色或 Light 浅色）和编辑器配色方案。

3.4 自定义插件

PyCharm 的功能可以通过插件极大扩展。初始设置会让你选择需要安装的插件。

必选：通常保持默认即可，例如对 Markdown、.ignore 文件的支持等。
可选：你可以根据需求启用或禁用特定插件，例如 "Vim" 模拟插件、"IdeaVim" 或各种框架支持插件。之后也可以在设置中随时管理。

3.5 创建启动器脚本

如之前所述，此时可以勾选 Create Desktop Entry 来创建快捷方式。

完成这些步骤后，你就会看到 PyCharm 的欢迎界面。

第四部分：核心功能与使用详解

4.1 创建和管理项目

创建新项目：

在欢迎界面点击 New Project。
在 Location 字段输入项目路径。
选择项目解释器：
- New environment using ：推荐。使用 Virtualenv, Pipenv 或 Conda 为项目创建一个独立的虚拟环境，避免包冲突。
- Previously configured interpreter：使用已有的解释器。
选择 Python 解释器位置（如果系统有多个 Python 版本）。
（可选）选择模板，如 Pure Python, Django, Flask 等。PyCharm 会为你生成基础项目结构。

python 复制代码

# 示例：创建一个简单的 main.py
def greet(name):
    print(f"Hello, {name}!")

if __name__ == "__main__":
    greet("PyCharm on Linux")

打开现有项目：

通过欢迎界面的 Open 或 Get from VCS（版本控制系统）可以打开已有项目。

4.2 用户界面导览

项目视图 (Project View)：左侧边栏，显示项目文件结构。
编辑器 (Editor)：中央区域，用于编写代码。
工具窗口 (Tool Windows) ：底部和两侧的窗口，如：
- 终端 (Terminal)：集成系统终端。
- Python 控制台 (Python Console)：交互式 Python 解释器。
- 运行 (Run)：显示程序输出和日志。
- 调试 (Debug)：用于调试程序，查看变量和调用栈。
- 问题 (Problems)：显示代码中的错误和警告。
导航栏 (Navigation Bar)：顶部显示当前文件路径，可以快速导航。

4.3 智能代码编辑

代码补全 (Code Completion) ：

按 Ctrl+Space 触发基础补全，PyCharm 会根据上下文提供精准的建议。

快速文档查看 (Quick Documentation) ：

将光标放在函数或类上，按 Ctrl+Q (Linux/Win) / F1 (Mac) 可以快速查看其文档字符串。

代码导航 (Navigation)：

跳转到定义 ： Ctrl+Click 或 Ctrl+B。
查找类/文件/符号 ： Ctrl+N / Ctrl+Shift+N / Ctrl+Alt+Shift+N。
查看最近文件 ： Ctrl+E。

重构 (Refactoring)：

重命名 ： Shift+F6，可以安全地重命名变量、函数、类等。
提取变量/方法 ： Ctrl+Alt+V / Ctrl+Alt+M，将选中的表达式提取为变量或方法。

python 复制代码

# 重构示例：提取变量
# 重构前：
area = 3.14159 * radius * radius

# 选中 3.14159 * radius * radius，按 Ctrl+Alt+V
# 重构后：
pi_value = 3.14159 * radius * radius
area = pi_value

4.4 强大的调试器

调试是 PyCharm 的强项。

设置断点：在代码行号旁点击，添加一个断点（红色圆点）。
开始调试 ：点击右上角的"虫子"图标或按 Shift+F9，以调试模式运行。
调试工具窗口 ：程序会在断点处暂停，你可以：
- 步进 (Step Over/Into/Out) ： F8 / F7 / Shift+F8。
- 查看变量 ：在 Variables 标签中查看当前作用域的所有变量值。
- 计算表达式 ：在 Watches 中添加你想监控的表达式。
- 查看调用栈 ：在 Frames 标签中查看函数调用链。

python 复制代码

# 调试示例：计算斐波那契数列
def fibonacci(n):
    if n <= 1:
        return n
    else:
        # 在此行设置断点
        return fibonacci(n-1) + fibonacci(n-2) # 按 F7 会步进到函数内部，按 F8 会步越过

result = fibonacci(5)
print(result)

4.5 测试集成

PyCharm 完美集成 unittest, pytest, doctest 等测试框架。

在测试文件或测试函数旁边会出现绿色的运行按钮。
点击按钮即可运行特定测试或整个测试套件。
结果会在 Run 工具窗口中显示，清晰看到通过/失败的测试。

python 复制代码

# 使用 pytest 的示例 (需安装 pytest 包)
# test_sample.py
def inc(x):
    return x + 1

def test_inc():
    assert inc(3) == 4  # 旁边会出现绿色箭头，点击即可运行此测试

4.6 版本控制集成 (Git)

PyCharm 提供了出色的 Git 支持。

初始化仓库 ： VCS -> Enable Version Control Integration。
提交更改 ： Ctrl+K。在提交前，可以预览更改、格式化代码、执行代码分析。
查看差异 ：在编辑器中右键修改过的文件，选择 Git -> Compare with Previous Revision。
推送/拉取 ： Ctrl+Shift+K / Ctrl+T。
解决冲突：遇到合并冲突时，PyCharm 会提供一个可视化的三窗格合并工具，让你轻松解决冲突。

第五部分：高级配置与技巧

5.1 配置 Python 解释器

为项目选择正确的解释器至关重要。

打开 File -> Settings -> Project: <your_project> -> Python Interpreter。
点击齿轮图标，选择 Add Interpreter。
你可以添加：
- 本地虚拟环境 ： Add Local Interpreter -> Virtualenv Environment。
- Conda 环境 ： Add Local Interpreter -> Conda Environment。
- 远程解释器 ： Add Remote Interpreter，通过 SSH、Docker 或 Vagrant 连接到远程机器或容器中的解释器。

5.2 调整外观和键映射

主题/字体 ： Settings -> Appearance & Behavior -> Appearance。
编辑器字体 ： Settings -> Editor -> Font。
键映射 ： Settings -> Keymap。你可以切换到其他 IDE（如 Eclipse, Visual Studio）的键映射习惯，或者自定义快捷键。

5.3 安装与配置插件

强大的插件生态系统是 PyCharm 的另一大优势。

打开 Settings -> Plugins。
切换到 Marketplace 标签，搜索你需要的插件。
推荐插件 ：
- IdeaVim：为编辑器提供 Vim 模拟。
- Rainbow Brackets：用不同颜色标识配对括号。
- CodeGlance：在编辑器右侧显示代码缩略图。
- Database Tools and SQL：（专业版自带）提供数据库管理功能。
- Mongo Plugin： MongoDB 集成。
- .ignore ：支持各种 .ignore 文件语法高亮。

5.4 使用远程解释器进行远程开发

对于需要在远程服务器或 Docker 容器中运行代码的场景，PyCharm 专业版提供了无缝支持。

配置 SSH 远程解释器：

在 Settings -> Python Interpreter 中添加新解释器。
选择 SSH Interpreter。
配置 SSH 连接信息（服务器地址、用户名、认证方式）。
选择远程服务器上 Python 解释器的路径。
PyCharm 会自动将本地项目文件同步到远程服务器，并在远程执行代码和调试，但编辑体验仍在本地，非常流畅。

第六部分：故障排除与性能优化

6.1 常见问题

无法输入中文 ：这是一个已知的 JetBrains IDE 在 Linux 上的问题。通常的解决方案是设置环境变量。编辑 PyCharm 的启动脚本（如 pycharm.sh 或在桌面条目的 Exec 命令前添加）：
bash 复制代码
```
export XMODIFIERS=@im=ibus  # 如果你使用 IBus
export GTK_IM_MODULE=ibus
export QT_IM_MODULE=ibus
# 或者对于 Fcitx
# export XMODIFIERS=@im=fcitx
# export GTK_IM_MODULE=fcitx
# export QT_IM_MODULE=fcitx
```
菜单栏不显示 ：某些窗口管理器（如 i3wm）可能需要设置环境变量 export JAVA_AWT_WM_NONREPARENTING=1。

6.2 性能优化

如果感觉 PyCharm 运行缓慢，可以尝试：

增加内存分配 ：
- 找到 PyCharm 的 vmoptions 文件。通常在 ~/.config/JetBrains/PyCharm2023.2/pycharm64.vmoptions (路径因版本而异)。
- 修改 -Xmx 参数（最大堆内存），例如 -Xmx2048m (2GB)。不要超过你系统物理内存的 1/4 到 1/3。
排除目录索引 ：
- 在 Settings -> Project -> Project Structure 中，将大型非代码目录（如 venv, __pycache__, .git, 数据文件目录）标记为 Excluded（右键目录 -> Exclude）。这可以加快文件索引和搜索速度。
关闭不必要的插件 ：在 Settings -> Plugins 中禁用不用的插件。

结论

PyCharm 是一款极其强大的 IDE，它与 Linux 系统的结合为 Python 开发者提供了近乎完美的开发体验。通过本指南，你应该已经掌握了在 Linux 系统上安装、配置 PyCharm 的核心方法，并对其主要功能和高阶用法有了深入的了解。

从灵活的安装方式到智能编码辅助，从强大的调试器到无缝的版本控制和远程开发支持，PyCharm 的每一个特性都旨在提升你的生产力和代码质量。花时间熟悉它的快捷键和配置选项，定制一个最适合你工作流的开发环境，必将让你在 Python 开发的道路上事半功倍。

引用与资源出处

JetBrains PyCharm 官方文档 ： https://www.jetbrains.com/pycharm/documentation/ - 本文的核心功能和配置说明均参考和遵循了官方文档的权威指南。
JetBrains PyCharm 下载页面 ： https://www.jetbrains.com/pycharm/download/#section=linux - 提供了官方 Tar.gz 包和 Snap 包的下载源。
JetBrains Toolbox App 官网 ： https://www.jetbrains.com/toolbox-app/ - Toolbox App 安装和管理方法的官方来源。
OpenJDK 官网 ： https://openjdk.java.net/ - 关于 Java 环境要求的参考。
Linux 中文输入问题社区讨论 ： https://youtrack.jetbrains.com/issue/IDEA-78860 - 针对 Linux 下 JetBrains IDE 中文输入问题的解决方案源自于官方 Issue 跟踪系统的用户讨论。
Python 官方文档 ： https://docs.python.org/3/ - 文中所有 Python 代码示例的语法和标准库用法均遵循 Python 官方规范。