Pycharm Python 开发环境设置教程 – wiki词典

作者： /

PyCharm Python 开发环境设置教程

PyCharm 是 JetBrains 公司开发的一款功能强大的 Python IDE (集成开发环境)，广泛用于 Python 项目的开发、调试、测试和部署。它提供了智能代码编辑、代码分析、图形化调试器、版本控制集成等一系列高级功能，极大地提高了开发效率。

本教程将详细指导您如何从零开始设置 PyCharm Python 开发环境。

目录

  1. 引言：为什么选择 PyCharm？
  2. 环境准备：安装 Python
  3. 安装 PyCharm
    • 下载 PyCharm
    • 安装 PyCharm
  4. 首次启动与配置
    • 导入设置（可选）
    • 用户协议与数据共享
    • 主题选择
    • 功能定制
  5. 创建您的第一个 PyCharm 项目
    • 选择项目类型
    • 配置项目路径
    • 选择或创建 Python 解释器 (强烈推荐虚拟环境)
  6. 管理 Python 依赖：安装与使用包
    • 通过 PyCharm 界面安装包
    • 通过终端安装包
  7. 运行和调试 Python 代码
    • 运行脚本
    • 设置断点与调试
  8. 常用 PyCharm 功能简介
    • 智能代码补全
    • 代码检查与快速修复
    • 重构
    • 版本控制集成
    • 终端
  9. 总结与进阶

1. 引言：为什么选择 PyCharm？

对于 Python 开发者来说，选择一个合适的 IDE 能够事半功倍。PyCharm 之所以受欢迎，是因为它提供了：

  • 智能代码编辑：语法高亮、智能代码补全、错误检查和快速修复。
  • 强大的调试器：图形化界面，支持断点、单步执行、变量查看等。
  • 集成工具：内置终端、版本控制（Git、SVN 等）集成、数据库工具。
  • 虚拟环境支持：轻松管理项目依赖，避免冲突。
  • 代码质量工具：代码分析、PEP 8 风格检查。
  • Web 开发框架支持：Django, Flask, Pyramid 等。
  • 科学工具支持：与 NumPy, Matplotlib, SciPy 等库良好集成。

PyCharm 有两个版本：
* Professional (专业版)：付费，功能最全面，适合专业开发者和团队。
* Community (社区版)：免费开源，提供核心的 Python 开发功能，对于个人学习和小型项目来说已经足够。

本教程主要以社区版为例进行讲解，但大部分设置步骤对专业版也同样适用。

2. 环境准备：安装 Python

在安装 PyCharm 之前，您需要先在计算机上安装 Python。PyCharm 本身不包含 Python 解释器，它需要依赖系统中已安装的 Python 来运行代码。

  1. 下载 Python：访问 Python 官方网站：https://www.python.org/downloads/。
  2. 选择版本：通常选择最新的稳定版本。
  3. 下载安装包：根据您的操作系统（Windows, macOS, Linux）下载对应的安装包。
  4. 安装 Python：
    • Windows：运行 .exe 安装程序。非常重要的一步是，在安装向导开始时，勾选 “Add Python X.Y to PATH” 选项。 这会将 Python 添加到系统环境变量中，方便后续使用。然后选择 “Install Now” 进行默认安装，或选择 “Customize installation” 进行自定义。
    • macOS：运行 .pkg 安装程序，按照提示完成安装。macOS 通常自带 Python 2，但您需要安装 Python 3。
    • Linux：大多数 Linux 发行版都预装了 Python，但您可能需要安装特定版本或开发工具。可以使用包管理器（如 apt 或 yum）安装。例如，在 Ubuntu 上：
      bash
      sudo apt update
      sudo apt install python3 python3-pip
  5. 验证安装：打开终端或命令提示符，输入以下命令检查 Python 是否成功安装并添加到 PATH：
    bash
    python --version # 或者 python3 --version
    pip --version # 或者 pip3 --version
    如果显示了 Python 和 pip 的版本号，则说明安装成功。

3. 安装 PyCharm

下载 PyCharm

  1. 访问 PyCharm 官方网站：https://www.jetbrains.com/pycharm/download/
  2. 在下载页面，选择您的操作系统，然后下载 Community (社区版)。当然，如果您有专业版授权，也可以下载 Professional 版本。

安装 PyCharm

  1. Windows：

    • 运行下载的 .exe 安装程序。
    • 点击 “Next”，选择安装路径（建议使用默认路径）。
    • 在 “Installation Options” 页面，建议勾选：
      • “Create Desktop Shortcut” (创建桌面快捷方式)
      • “Add ‘Open Folder as Project'” (添加到右键菜单，方便直接打开项目)
      • “Add Launchers dir to the PATH” (将启动器目录添加到 PATH，允许从命令行启动 PyCharm)
      • “64-bit launcher” (如果您的系统是 64 位)
    • 点击 “Next”，选择开始菜单文件夹，然后点击 “Install”。
    • 安装完成后，您可以选择 “Run PyCharm Community Edition” 立即启动。

  2. macOS：

    • 打开下载的 .dmg 文件。
    • 将 PyCharm CE 图标拖到 “Applications” 文件夹中。
    • 关闭 .dmg 窗口，并将它从 Finder 侧边栏弹出。

  3. Linux：

    • 下载的通常是 .tar.gz 压缩包。
    • 打开终端，解压文件到您选择的安装目录（例如 /opt）：
      bash
      sudo tar -xzf pycharm-community-*.tar.gz -C /opt/
    • 进入解压后的 bin 目录：
      bash
      cd /opt/pycharm-community-*/bin/
    • 运行 pycharm.sh 脚本启动 PyCharm：
      bash
      ./pycharm.sh
    • 首次启动后，您可以选择创建桌面快捷方式或添加到应用程序菜单。

4. 首次启动与配置

首次启动 PyCharm 时，您会看到一系列配置向导。

  1. 导入设置 (Import Settings)：如果您之前安装过 PyCharm 并有配置备份，可以选择导入。否则，选择 “Do not import settings”。
  2. 用户协议 (User Agreement)：阅读并接受 JetBrains 用户协议。
  3. 数据共享 (Data Sharing)：根据您的偏好，选择是否向 JetBrains 发送匿名使用数据。
  4. 主题选择 (UI Theme)：选择您喜欢的主题，例如 “Darcula” (暗色) 或 “Light” (亮色)。
  5. 功能定制 (Customize)：
    • IDE features：您可以选择安装或禁用某些插件。对于初学者，保持默认即可。
    • Featured plugins：推荐安装 Git，因为它几乎是所有项目的必需品。其他插件可以根据需要后续安装。

完成这些步骤后，PyCharm 就会进入欢迎界面。

5. 创建您的第一个 PyCharm 项目

现在，让我们创建一个新的 Python 项目。

  1. 在欢迎界面，点击 “New Project”。

  2. 新项目配置 (New Project)：

    • Location (位置)：

      • Project name (项目名称)：输入您的项目名称，例如 MyPythonProject。
      • Location (路径)：PyCharm 会自动为您建议一个项目目录（通常在用户目录下的 PyCharmProjects 中）。您可以根据需要修改路径。

    • Python Interpreter (Python 解释器)：这是最关键的一步，强烈推荐使用 “Virtualenv” (虚拟环境)。

      • 什么是虚拟环境？ 虚拟环境是一个独立的 Python 运行环境，它包含了 Python 解释器和项目所需的特定库。每个项目都可以有自己的虚拟环境，这样可以避免不同项目之间库版本冲突的问题。例如，项目 A 需要 Django 2.x，而项目 B 需要 Django 3.x，虚拟环境可以确保它们各自独立运行互不影响。
      • 如何配置虚拟环境：
        • 选择 “New environment using Virtualenv”。
        • Location (位置)：这是虚拟环境的安装路径。PyCharm 会默认将其放在项目根目录下的 .venv 文件夹中，这是一个很好的做法，保持默认即可。
        • Base interpreter (基础解释器)：选择您系统中已安装的 Python 版本（例如 python3.10 或 python3.11）。PyCharm 会自动检测到。如果您安装了多个 Python 版本，请选择您希望项目使用的版本。
        • Inherit global site-packages (继承全局 site-packages)：通常不勾选。 勾选后，虚拟环境会继承全局 Python 环境中安装的所有库。这会违背虚拟环境的隔离原则，不推荐。
        • Make available to all projects (对所有项目可用)：通常不勾选。 勾选后，这个虚拟环境会变为全局可用，同样不推荐，每个项目最好有自己的独立虚拟环境。

    • Create a main.py welcome script (创建 main.py 欢迎脚本)：勾选此选项，PyCharm 会自动为您创建一个简单的 main.py 文件，其中包含一个 print("Hi, PyCharm") 语句，方便您快速验证环境。

  3. 点击 “Create”。PyCharm 会开始创建项目和虚拟环境，这可能需要一些时间。完成后，您会看到 PyCharm 的主界面。

6. 管理 Python 依赖：安装与使用包

Python 项目通常依赖于各种第三方库（也称为包或模块）。PyCharm 提供了多种方式来安装和管理这些包。

通过 PyCharm 界面安装包

这是最直观的方式：

  1. 打开 PyCharm 项目后，在左侧的 “Project” 工具窗口中，找到您的项目根目录。
  2. 点击菜单栏中的 “File” -> “Settings…” (Windows/Linux) 或 “PyCharm” -> “Preferences…” (macOS)。
  3. 在弹出的 “Settings/Preferences” 窗口中，导航到 “Project: YourProjectName” -> “Python Interpreter”。
  4. 您会看到当前项目使用的 Python 解释器和已安装的包列表。
  5. 点击窗口右侧的 “+” (Add) 按钮。
  6. 在弹出的 “Available Packages” 窗口中，您可以：
    • 搜索：输入您想要安装的包的名称，例如 requests。
    • 选择版本：勾选 “Specify version” 可以选择特定的包版本。
    • 安装：点击 “Install Package” 按钮。
  7. 安装完成后，您会在 “Python Interpreter” 页面看到新安装的包。点击 “OK” 关闭设置。

通过终端安装包

PyCharm 内置了终端，您可以像在系统终端中一样使用 pip 命令来安装包。

  1. 在 PyCharm 底部工具栏找到 “Terminal” 标签页并点击打开。
  2. 您会发现终端的路径已经自动切换到了您的项目根目录，并且虚拟环境也已经被激活（通常会显示虚拟环境的名称，例如 (.venv) 或 (venv) 在命令行提示符前面）。
  3. 现在，您可以使用 pip 命令安装包。例如，要安装 requests 库：
    bash
    pip install requests
  4. 要安装特定版本的包：
    bash
    pip install django==3.2.10
  5. 要查看已安装的包：
    bash
    pip list
  6. 管理项目依赖文件 (requirements.txt)：
    • 在实际项目中，我们通常会将所有依赖包及其版本记录在 requirements.txt 文件中。
    • 生成 requirements.txt：
      bash
      pip freeze > requirements.txt
    • 从 requirements.txt 安装所有依赖：
      bash
      pip install -r requirements.txt

7. 运行和调试 Python 代码

PyCharm 提供了强大的工具来运行和调试您的代码。

运行脚本

  1. 直接运行：
    • 在 “Project” 工具窗口中双击打开 main.py 文件。
    • 在代码编辑区右键点击，选择 “Run ‘main'”。
    • 或者，点击 PyCharm 工具栏上的绿色 “Run” (播放按钮) 图标。
    • 或者，使用快捷键 Shift + F10 (Windows/Linux) 或 Ctrl + R (macOS)。
  2. 查看输出：运行结果会在底部的 “Run” 工具窗口中显示。

设置断点与调试

调试是查找和修复代码中错误的关键过程。

  1. 设置断点：

    • 在您想要暂停代码执行的行号左侧（代码编辑区的灰色边距），单击鼠标左键。会出现一个红色的圆点，表示断点已设置。
    • 例如，在 main.py 中的 print("Hi, PyCharm") 这一行设置一个断点。

  2. 启动调试：

    • 在代码编辑区右键点击，选择 “Debug ‘main'”。
    • 或者，点击 PyCharm 工具栏上的绿色 “Debug” (带有臭虫图标的播放按钮) 图标。
    • 或者，使用快捷键 Shift + F9 (Windows/Linux) 或 Ctrl + D (macOS)。

  3. 调试器界面：

    • 当代码执行到断点时，程序会暂停，PyCharm 会切换到 “Debug” 工具窗口。
    • Frames (栈帧)：显示当前的函数调用栈。
    • Variables (变量)：显示当前作用域内的所有变量及其值。您可以展开对象查看其内部属性。
    • Console (控制台)：显示程序的标准输出和错误输出。
    • Watches (监视)：您可以添加特定的表达式来实时监视它们的值。

  4. 调试操作：

    • Step Over (步过) (F8)：执行当前行代码，如果当前行是函数调用，则跳过函数内部，直接执行到下一行。
    • Step Into (步入) (F7)：执行当前行代码，如果当前行是函数调用，则进入函数内部执行。
    • Step Out (步出) (Shift + F8)：从当前函数中跳出，执行到调用该函数的下一行。
    • Run to Cursor (运行到光标) (Alt + F9)：运行代码直到光标所在的位置。
    • Resume Program (恢复程序) (F9)：继续执行代码，直到下一个断点或程序结束。
    • Stop (停止) (Ctrl + F2)：停止当前调试会话。

8. 常用 PyCharm 功能简介

PyCharm 不仅仅是一个编辑器，它还集成了许多强大的功能来提升开发体验。

  • 智能代码补全 (IntelliSense)：在您输入代码时，PyCharm 会自动提供相关的代码建议，包括变量、函数、类、模块等。
  • 代码检查与快速修复 (Code Inspection & Quick Fixes)：PyCharm 会实时检查您的代码，指出潜在的错误、不符合 PEP 8 规范的代码风格、性能问题等，并提供一键修复 (Quick Fix) 选项。当出现警告或错误时，将光标放在代码上，按 Alt + Enter (Windows/Linux) 或 Option + Enter (macOS) 可以看到修复建议。
  • 重构 (Refactoring)：PyCharm 提供了一系列强大的重构工具，例如：
    • Rename (重命名) (Shift + F6)：安全地重命名变量、函数、类、文件等，并自动更新所有引用。
    • Extract Method/Variable (提取方法/变量)：将一段代码提取为一个新函数或变量。
    • Change Signature (改变签名)：修改函数或方法的参数列表。
  • 版本控制集成 (VCS Integration)：PyCharm 深度集成了 Git、SVN 等版本控制系统。
    • 您可以在 “VCS” 菜单中执行常见的版本控制操作，如 Commit (提交)、Update Project (更新项目)、Push (推送)、Pull (拉取) 等。
    • 在代码编辑区，您可以看到代码的修改历史，以及与版本库的差异。
  • 终端 (Terminal)：前面已经提到，内置终端允许您直接在 IDE 中执行命令行操作，无需切换应用程序。
  • 数据库工具 (Database Tools)：专业版 PyCharm 提供了强大的数据库管理工具，可以直接连接、查询和管理多种数据库。
  • TODO/FIXME 注释：PyCharm 会自动识别代码中的 TODO 或 FIXME 注释，并在 “TODO” 工具窗口中列出，方便您跟踪未完成的任务。

9. 总结与进阶

通过本教程，您应该已经成功设置了 PyCharm Python 开发环境，并了解了如何创建项目、管理依赖、运行和调试代码以及使用一些基本但强大的功能。

接下来，您可以进一步探索 PyCharm 的以下功能：

  • 快捷键：熟练掌握快捷键能显著提高开发效率。可以在 “File” -> “Settings/Preferences” -> “Keymap” 中查看和自定义。
  • 代码风格与格式化：配置代码风格 (PEP 8)，使用 “Reformat Code” (Ctrl + Alt + L 或 Cmd + Alt + L) 统一代码格式。
  • 单元测试：PyCharm 支持 unittest, pytest 等测试框架，可以方便地运行和调试测试。
  • 插件市场：访问 “File” -> “Settings/Preferences” -> “Plugins” 安装更多有用的插件，例如 Markdown 支持、主题等。
  • 远程开发/SSH 解释器：专业版支持在远程服务器上运行代码和调试。

PyCharm 是一个功能丰富的 IDE，深入学习和利用它的各项功能，将使您的 Python 开发之旅更加高效和愉快。祝您编码愉快！

滚动至顶部