PyCharm Community Edition 安装与使用教程 – wiki大全

作者： /

PyCharm Community Edition：Python 开发者的利器——安装与使用全攻略

PyCharm 是 JetBrains 公司开发的一款功能强大的 Python 集成开发环境（IDE），被广大 Python 开发者视为首选工具。它提供了智能代码编辑、调试、测试、版本控制集成等一系列功能，极大地提升了开发效率。本文将详细介绍 PyCharm Community Edition（社区版）的安装过程以及基本使用方法，助您快速上手。

PyCharm 社区版是免费且开源的，对于个人开发者、学生以及非商业项目来说，是完全够用的。

一、PyCharm Community Edition 安装教程

1. 下载 PyCharm Community Edition

首先，您需要从 JetBrains 官网下载 PyCharm 社区版安装包。

  • 访问官网： 打开浏览器，访问 JetBrains PyCharm 下载页面：https://www.jetbrains.com/pycharm/download/
  • 选择社区版： 在下载页面，您会看到“Professional”（专业版）和“Community”（社区版）两个选项。请选择 Community 下的“Download”按钮。
  • 选择操作系统： 网站会自动检测您的操作系统（Windows, macOS, Linux），并提供相应的安装包下载链接。点击下载。

2. 安装 PyCharm Community Edition

下载完成后，根据您的操作系统执行以下安装步骤：

对于 Windows 用户：

  1. 运行安装程序： 找到下载的 .exe 文件，双击运行。
  2. 欢迎界面： 点击“Next”。
  3. 选择安装路径： 建议保持默认路径，或选择一个您方便管理的路径。确保有足够的磁盘空间。点击“Next”。
  4. 安装选项： 这一步很重要，建议勾选以下选项：
    • Create Desktop Shortcut: 根据您的系统位数选择 32-bit 或 64-bit，方便从桌面启动。
    • Add “Open Folder as Project”: 方便您右键点击文件夹直接用 PyCharm 打开项目。
    • Add “bin” folder to PATH: 强烈推荐勾选。这会将 PyCharm 的可执行文件路径添加到系统环境变量 PATH 中，方便您在命令行中直接启动 PyCharm。
    • Download and install JBR (Java Runtime): 默认勾选，让 PyCharm 自带 Java 运行环境，无需额外安装 Java。
      点击“Next”。
  5. 选择开始菜单文件夹： 保持默认即可。点击“Install”。
  6. 等待安装完成： 安装过程可能需要几分钟。
  7. 完成安装： 勾选“Run PyCharm Community Edition”并点击“Finish”以立即启动 PyCharm，或取消勾选稍后手动启动。

对于 macOS 用户：

  1. 打开 .dmg 文件： 找到下载的 .dmg 文件，双击打开。
  2. 拖拽应用程序： 将 PyCharm CE 图标拖拽到“Applications”文件夹中。
  3. 启动 PyCharm： 打开“Applications”文件夹，双击 PyCharm CE 图标即可启动。首次启动可能会有安全提示，点击“打开”或“Allow”。

对于 Linux 用户：

  1. 解压安装包： 找到下载的 .tar.gz 文件，将其解压到您希望安装的目录，例如 /opt/ 或您的用户主目录下的 ~/Software/。
    bash
    sudo tar -xzf pycharm-community-*.tar.gz -C /opt/
  2. 运行安装脚本： 进入解压后的 bin 目录，运行 pycharm.sh。
    bash
    cd /opt/pycharm-community-edition-*/bin
    ./pycharm.sh
  3. 创建桌面启动器 (可选)： 在 PyCharm 启动后，可以通过 Tools -> Create Desktop Entry... 创建桌面快捷方式，方便下次启动。

二、PyCharm Community Edition 首次启动与初始化设置

首次启动 PyCharm 时，您需要进行一些初始配置：

  1. 导入设置： 如果您之前安装过 PyCharm 并导出了设置，可以选择“Config or installation folder”导入。否则，选择“Do not import settings”，点击“OK”。
  2. 用户协议： 阅读并接受用户协议，点击“Accept”。
  3. 数据共享： 选择是否向 JetBrains 发送匿名统计数据。您可以选择“Don’t Send”或“Send Anonymous Statistics”。
  4. UI 主题： 选择您喜欢的主题（例如 Darcula 黑色主题或 Light 白色主题）。点击“Next: Keymap Schemes”。
  5. 快捷键方案： 如果您熟悉其他 IDE 的快捷键（如 Eclipse, VSCode），可以选择对应的方案。否则，保持默认的“Windows/macOS/Linux”方案。点击“Next: Launcher Script”。
  6. 创建启动脚本 (macOS/Linux)： 建议勾选，这会在系统路径中创建一个 pycharm 命令，方便从终端启动 PyCharm。
  7. 插件： 这一步可以先跳过，以后再根据需要安装插件。点击“Start using PyCharm”。

至此，PyCharm 就成功启动并配置完成了！

三、创建您的第一个 Python 项目

  1. 进入欢迎界面： PyCharm 启动后，您会看到欢迎界面。
  2. 创建新项目： 点击“New Project”。
  3. 配置新项目：
    • Location (项目路径)： 选择您的项目将存储的目录。PyCharm 会自动在您选择的目录下创建一个与项目同名的文件夹。
    • New environment using (虚拟环境)： 强烈推荐选择 Virtualenv。虚拟环境可以隔离不同项目的 Python 依赖，避免版本冲突。
      • Location: 虚拟环境将创建的路径，通常保持默认即可（在项目根目录下）。
      • Base interpreter: 选择您系统上已安装的 Python 解释器（例如 Python 3.9 或 Python 3.10）。如果您没有安装 Python，请先安装。
    • Create a main.py welcome script: 建议勾选，PyCharm 会自动为您创建一个简单的 main.py 文件，方便您立即开始编写代码。
  4. 创建项目： 点击“Create”。

PyCharm 会开始创建虚拟环境并加载项目，这可能需要一些时间。完成后，您将看到 PyCharm 的主界面，其中包含项目文件结构、代码编辑器等。

四、PyCharm 基本使用

1. 代码编辑器

这是您编写 Python 代码的主要区域。

  • 智能代码补全： 当您输入代码时，PyCharm 会自动提供建议。
  • 语法高亮： 不同类型的代码元素会以不同颜色显示，提高可读性。
  • 错误和警告提示： PyCharm 会实时检查您的代码，并在发现语法错误或潜在问题时给出提示（通常用红色波浪线表示错误，黄色波浪线表示警告）。
  • 代码格式化： 使用 Ctrl+Alt+L (Windows/Linux) 或 Cmd+Option+L (macOS) 可以自动格式化代码，使其符合 PEP 8 规范。

2. 运行您的代码

您可以通过多种方式运行 Python 文件：

  • 右键运行： 在项目树中右键点击 main.py 文件，选择“Run ‘main’”。
  • 顶部运行按钮： 在工具栏上找到绿色的运行按钮（一个三角形），点击即可运行当前文件。
  • 快捷键： Shift+F10 (Windows/Linux) 或 Ctrl+R (macOS)。
  • Run/Debug Configuration： 对于更复杂的运行配置（如带命令行参数），可以在顶部下拉菜单中选择“Edit Configurations…”。

运行结果会在底部的“Run”窗口中显示。

3. 调试您的代码

调试是找出代码问题的重要手段。

  1. 设置断点： 在您希望暂停代码执行的行号左侧单击，会出现一个红点，这就是断点。
  2. 启动调试： 点击工具栏上的“Debug”按钮（一个绿色虫子图标），或使用快捷键 Shift+F9 (Windows/Linux) / Ctrl+D (macOS)。
  3. 调试器界面： 代码会在断点处暂停。您可以使用调试器面板中的按钮进行操作：
    • Step Over (F8)： 执行当前行，但不进入函数内部。
    • Step Into (F7)： 执行当前行，如果当前行是函数调用，则进入函数内部。
    • Step Out (Shift+F8)： 从当前函数跳出。
    • Resume Program (F9)： 继续执行直到下一个断点或程序结束。
    • Variables (变量窗口)： 查看当前作用域内所有变量的值。

4. 终端 (Terminal)

PyCharm 内置了终端，您可以在其中执行命令行操作，如安装依赖、运行脚本、Git 命令等。

  • 打开终端： 在底部工具栏找到“Terminal”选项卡并点击。
  • 激活虚拟环境： PyCharm 的内置终端通常会自动激活当前项目的虚拟环境。您会看到命令行提示符前有 (venv) 或其他虚拟环境名称的标识。

5. 版本控制 (VCS) 集成

PyCharm 对 Git、Mercurial 等版本控制系统提供了原生支持。

  • 启用 VCS： VCS -> Enable Version Control Integration...，选择您的版本控制系统（如 Git）。
  • 常用操作： 在菜单栏 Git 下或右键文件/文件夹，您可以进行 Commit（提交）、Pull（拉取）、Push（推送）、Branch（分支）等操作。

6. 包管理 (Package Manager)

在 PyCharm 中管理 Python 包非常方便。

  1. 打开设置： File -> Settings (Windows/Linux) 或 PyCharm -> Preferences (macOS)。
  2. 进入项目解释器： 展开“Project: [Your Project Name]”，选择“Python Interpreter”。
  3. 管理包： 在右侧面板中，您可以看到当前虚拟环境已安装的包。
    • 点击 + 按钮可以搜索并安装新的包。
    • 点击 - 按钮可以卸载选定的包。
    • 点击 ↑ 按钮可以升级包。

五、常用 PyCharm 设置

PyCharm 提供了丰富的配置选项，您可以根据个人喜好进行调整。

  1. 打开设置： File -> Settings (Windows/Linux) 或 PyCharm -> Preferences (macOS)。
  2. 常用设置项：
    • Appearance & Behavior: 调整 UI 外观、字体大小等。
    • Editor: 配置代码编辑器行为，如字体、颜色方案、代码样式、自动保存等。
      • Font: 调整编辑器字体和大小。
      • Code Style: 调整代码格式化规则，如缩进、空格等。
      • General -> Auto Import: 自动导入模块。
    • Keymap: 查看和自定义快捷键。
    • Plugins: 管理和安装 PyCharm 插件，扩展功能。

六、结语

通过本文的详细指导，您应该已经成功安装了 PyCharm Community Edition 并掌握了基本的项目创建和开发流程。PyCharm 还有更多高级功能等待您探索，如代码重构、测试工具集成、数据库工具等。熟练使用 PyCharm 将极大地提升您的 Python 开发体验和效率。现在，开始您的 Python 编程之旅吧！

滚动至顶部