PyCharm Community Edition 介绍与入门 – wiki基地

PyCharm Community Edition 介绍与入门：从零开始玩转强大的 Python IDE

引言

Python 作为一门语法简洁、功能强大的编程语言，在Web开发、数据科学、人工智能、自动化脚本等众多领域都占据着举足轻重的位置。随着项目规模的增长和复杂度的提高，一个高效的开发环境对于提升开发效率、保证代码质量至关重要。虽然文本编辑器（如VS Code, Sublime Text, Vim等）配合插件也能进行Python开发，但集成开发环境（IDE）能够提供更全面的功能集成，带来更流畅的开发体验。

在众多Python IDE中，JetBrains 公司出品的 PyCharm 无疑是其中的佼佼者。它提供了智能代码编辑、强大的调试工具、版本控制集成、科学计算工具支持等一系列专业功能。PyCharm 分为两个版本：Professional Edition（专业版）和 Community Edition（社区版）。专业版功能更为齐全，支持Web框架、科学计算库、数据库工具等高级特性；而社区版则是免费且开源的，虽然功能相对精简，但对于大多数Python开发者，尤其是初学者、进行脚本开发、基础数据分析或开源项目贡献者来说，PyCharm Community Edition (简称 PCE 或 PyCharm CE) 已经提供了足够的强大功能，足以应对日常开发需求。

本文将带您深入了解 PyCharm Community Edition，包括其核心特性、与专业版的区别，并提供一个详细的入门指南，从安装到编写第一个程序、运行、调试、管理依赖，帮助您从零开始，掌握这款强大的Python IDE。

第一部分：PyCharm Community Edition 介绍

什么是 IDE？为什么选择 PyCharm？

在深入了解 PyCharm CE 之前，我们先来理解一下什么是 IDE。IDE，即集成开发环境（Integrated Development Environment），是一种集成了代码编辑器、编译器/解释器、调试器、构建工具等多种开发工具的应用程序。与仅仅提供代码编辑功能的文本编辑器不同，IDE 旨在提供一个一站式的解决方案，让开发者可以在一个统一的环境中完成从代码编写、运行、调试到部署的几乎所有任务。

选择 PyCharm 作为 Python 开发环境，是因为它在以下几个方面表现出色：

智能代码辅助： PyCharm 提供了业界领先的代码编辑体验，包括语法高亮、智能代码补全、实时错误检查、代码格式化、代码重构等，显著提高编码速度和准确性。
强大的调试器： 图形化调试界面让您可以轻松设置断点、逐行执行代码、检查变量值、评估表达式，帮助您快速定位和解决程序中的 bug。
虚拟环境管理： Python 项目经常需要依赖特定的库版本，使用虚拟环境可以隔离不同项目的依赖，避免冲突。PyCharm 内置了便捷的虚拟环境管理工具，让创建和切换虚拟环境变得异常简单。
集成包管理器： 无需离开 IDE，就可以方便地通过图形界面搜索、安装、升级和删除 Python 包（使用 pip 或 Conda）。
版本控制集成： PyCharm 与 Git、Mercurial、SVN 等主流版本控制系统无缝集成，让您可以直接在 IDE 内进行提交、推送、拉取、分支管理等操作，简化团队协作和代码管理。
内置终端： 直接在 IDE 底部打开命令行终端，方便执行各种 shell 命令。
高度可定制： PyCharm 的外观、快捷键、编辑器行为等都可以根据个人喜好进行细致的配置。
跨平台： 支持 Windows、macOS 和 Linux 三大主流操作系统。

PyCharm Community Edition 的核心特性

PyCharm Community Edition 虽然是免费版本，但它保留了 PyCharm 最核心和最实用的功能，足以满足绝大多数 Python 开发场景，特别是对于学习、开发脚本、进行算法实现或参与开源项目等非 Web/企业级应用开发。其主要特性包括：

智能代码编辑器：
- 语法高亮： 根据 Python 语法为不同类型的代码元素着色，提高代码可读性。
- 代码补全： 基于上下文提供智能的代码建议，包括变量名、函数名、类名、模块成员等，极大地减少手动输入和记忆量。
- 实时错误和警告检查： 在您编写代码时即时指出语法错误、未定义变量、潜在的逻辑问题等，帮助您及时发现并修正问题。
- 代码格式化： 根据PEP 8或其他自定义规范自动或手动格式化代码，保持代码风格统一。
- 代码检查（Inspections）： 提供各种代码质量检查，如找出死代码、重复代码、不符合PEP 8规范的地方等。
- 代码重构： 支持安全、高效的代码重构操作，如变量重命名、方法提取、类提取等，帮助您改进代码结构。
代码导航： 快速跳转到变量、函数、类的定义处，查找变量或方法的所有使用位置，查看类的层级结构等。
强大的调试器： 支持设置行断点、条件断点，提供了变量查看器、调用栈、表达式求值等功能，让调试过程直观高效。
集成单元测试： 支持运行和调试流行的Python测试框架（如unittest、pytest、nose），并在图形界面中查看测试结果。
版本控制系统集成： 支持 Git、Mercurial、SVN 等，提供 Commit、Push、Pull、Branching、Merging、Conflict Resolution 等常用操作的图形界面支持。
虚拟环境管理： 支持创建、配置和切换 Virtualenv、venv 环境，并能方便地管理项目依赖。
内置终端： 提供一个集成的命令行窗口，方便执行终端命令。
数据库工具（基础）： 社区版提供基础的数据库连接和查看功能，但高级的编辑、查询控制台、图示等功能需要专业版。
插件系统： 可以安装各种插件扩展 PyCharm 的功能，例如支持其他语言、添加新的工具窗口等。

PyCharm Community Edition 与 Professional Edition 的主要区别

了解社区版的功能限制有助于您判断它是否满足您的需求，以及何时可能需要考虑升级到专业版。下表列出了一些主要区别：

功能特性	PyCharm Community Edition	PyCharm Professional Edition
Web 开发框架支持	不支持	支持 Django, Flask, Pyramid, Web2Py 等
科学计算工具	基础支持 (集成终端)	增强支持，包括 NumPy, SciPy, Matplotlib 集成，交互式科学模式，Jupyter Notebook 支持
数据库工具	基础连接与查看	全功能数据库管理，SQL 控制台，数据编辑，模式图示
模板语言支持	不支持	支持 HTML, CSS, JavaScript 以及 Django/Jask/Jinja2 模板
远程开发	不支持	支持通过 SSH 解释器在远程服务器上运行和调试代码
Profiling 工具	不支持	提供代码性能分析工具
Collaboration Tools	不支持	支持 Code With Me 等协作工具
代码覆盖率报告	不支持	支持生成测试覆盖率报告
应用服务器集成	不支持	支持各种应用服务器的部署和调试

总的来说，如果您主要进行 Python 脚本编写、学习 Python 基础、进行离线数据处理、参与开源项目或进行算法实现等，PyCharm Community Edition 通常是足够且非常出色的选择。如果您需要进行专业的 Web 开发（特别是使用 Django 或 Flask）、深入进行科学计算（如数据分析、机器学习）、需要强大的数据库工具或远程开发功能，那么 PyCharm Professional Edition 将是更好的选择。

第二部分：PyCharm Community Edition 入门

现在，让我们一步步开始使用 PyCharm Community Edition。

第一步：下载与安装 PyCharm CE

访问官网： 打开浏览器，访问 JetBrains 官方网站的 PyCharm 下载页面：https://www.jetbrains.com/pycharm/download/
选择版本： 在下载页面，您会看到 Professional 和 Community 两个版本。请确保您点击的是 Community 版本的下载按钮。网站会自动检测您的操作系统（Windows, macOS, Linux），并提供相应的安装包。
下载安装包： 点击下载按钮，保存安装包到您的电脑。
运行安装程序： 找到下载的安装包并运行。
- Windows: 运行 .exe 文件。按照安装向导提示操作。在安装选项中，建议勾选 “Add ‘Open Folder as Project'”（添加到右键菜单）和 “Add launchers dir to the PATH”（添加到环境变量，方便从命令行启动）。关联 .py 文件也是个不错的选择。
- macOS: 运行 .dmg 文件。将 PyCharm CE 图标拖到 Applications 文件夹中。
- Linux: 下载 .tar.gz 文件。解压后，进入解压后的 bin 目录，运行 ./pycharm.sh 脚本启动。为了方便，您可以创建一个桌面快捷方式或将其添加到系统 PATH。
完成安装并首次启动： 安装完成后，首次启动 PyCharm 可能需要进行一些初始配置。
- 隐私政策： 接受用户协议和隐私政策。
- 数据共享： 选择是否向 JetBrains 发送匿名使用统计数据（可选）。
- 主题选择： 选择 UI 主题（如 Darcula 深色主题或 Light 浅色主题）和编辑器配色方案。
- 键位映射（Keymap）： 如果您之前使用过其他 IDE（如 VS Code, Eclipse）并习惯了其快捷键，可以在这里选择对应的 Keymap。初学者可以选择默认的 IntelliJ/PyCharm Keymap。
- 插件： 首次启动可能会推荐安装一些常用插件，您可以根据需要选择，或者跳过稍后再安装。
- 导入设置： 如果您之前安装过 PyCharm，可以选择导入之前的设置。

完成这些初始设置后，您将看到 PyCharm 的欢迎界面。

第二步：创建您的第一个项目

在 PyCharm 中，所有的开发活动都是基于“项目”进行的。一个项目通常对应一个独立的应用程序、库或脚本集合。

从欢迎界面创建： 在欢迎界面，点击 New Project。
配置项目：
- Location: 选择项目文件存放的目录。给您的项目起一个有意义的名字（例如 MyFirstPyProject），它将作为项目文件夹的名称。
- Interpreter: 这是最关键的一步。您需要为项目选择一个 Python 解释器。PyCharm 强烈推荐为每个项目创建一个独立的虚拟环境。
  - 选择 New environment using Virtualenv (或 venv，取决于您的操作系统和安装)。
  - Base interpreter: 选择您系统上已经安装的 Python 版本（例如 Python 3.8, 3.9, 3.10等）。如果您系统上没有安装 Python，需要先安装一个（可以从 python.org 下载）。
  - Location: 虚拟环境将创建在此目录下。PyCharm 默认在项目目录下创建一个名为 venv（或其他类似名称）的子文件夹来存放虚拟环境，这是一个推荐的做法。
  - Inherit global site-packages: 通常不勾选。勾选此项会包含系统全局 Python 环境中已安装的所有包，这可能会导致项目之间的依赖冲突，违背虚拟环境隔离的初衷。
  - Make available to all projects: 通常不勾选。如果勾选，这个虚拟环境可以在其他项目中重复使用，但这不符合为每个项目独立创建虚拟环境的最佳实践。
- Create a main.py welcome script: 勾选此项可以在创建项目时自动生成一个简单的 main.py 文件，方便快速开始。
点击 Create： PyCharm 会开始创建项目目录和虚拟环境。这个过程可能需要一些时间，因为它需要下载和设置虚拟环境所需的文件。

项目创建完成后，PyCharm 会打开主界面。

第三步：熟悉 PyCharm 的界面

首次打开项目后，您会看到 PyCharm 的主界面，它主要由以下几个区域组成：

项目工具窗口 (Project Tool Window): 通常位于左侧。它以树状结构显示您的项目文件和目录。您可以在这里浏览、创建、删除、重命名文件和文件夹。可以通过 Alt+1 (Windows/Linux) 或 Cmd+1 (macOS) 快捷键显示/隐藏。
编辑器区域 (Editor Area): 位于中间，是您编写和查看代码的主要区域。每个打开的文件都会显示为一个选项卡。PyCharm 的智能代码辅助功能主要体现在这里。
导航栏 (Navigation Bar): 位于编辑器区域上方，显示当前文件的路径，并提供一些快捷操作，如运行、调试、搜索等。
工具窗口栏 (Tool Window Bars): 分布在窗口的底部和两侧边缘，包含了一系列可折叠/展开的工具窗口按钮，如 Terminal（终端）、Python Console（Python 控制台）、Run（运行）、Debug（调试）、Version Control（版本控制）、Structure（结构）等。点击按钮可以打开相应的工具窗口。
状态栏 (Status Bar): 位于窗口底部，显示当前文件的行号列号、文件编码、行尾符、Python解释器信息等，并提供一些快捷访问设置的入口。

第四步：编写您的第一个 Python 代码

现在，让我们在 PyCharm 中编写一个简单的 Python 程序。

创建 Python 文件：
- 在项目工具窗口中，右键点击您的项目根目录（例如 MyFirstPyProject）。
- 选择 New > Python File。
- 输入文件名（例如 hello.py），然后按 Enter。PyCharm 会自动添加 .py 后缀。
编写代码： 在新打开的 hello.py 编辑器中输入以下代码：

“`python
def greet(name):
“””This function greets the person passed in as a parameter.”””
print(f”Hello, {name}!”)

if name == “main“:
user_name = “PyCharm User”
greet(user_name)
“`

注意观察：
* PyCharm 如何对代码进行语法高亮。
* 当您输入 print( 时，PyCharm 会显示函数的签名和文档字符串提示。
* 当您输入 user_name. 并按下 . 时，PyCharm 会尝试提供补全建议（尽管对于字符串变量可能不明显，但在使用对象时非常有用）。
* PyCharm 可能会在代码下方出现波浪线，表示警告或错误。例如，如果您没有使用 f-string 而是传统的格式化方式，它可能会建议您转换为 f-string。
格式化代码： 在编辑器中，您可以按下 Ctrl+Alt+L (Windows/Linux) 或 Cmd+Option+L (macOS) 来自动格式化当前文件的代码，使其符合 PEP 8 规范（默认情况下）。

第五步：运行您的代码

有几种方式可以在 PyCharm 中运行 Python 代码：

使用右键菜单：
- 在 hello.py 编辑器中任意位置右键点击。
- 选择 Run ‘hello’。
使用运行按钮：
- 如果文件中有 if __name__ == "__main__": 块，PyCharm 会在旁边显示一个绿色的小三角形。点击这个三角形，然后选择 Run ‘hello’。
- 或者在导航栏上选择当前的运行配置（如果文件已经运行过一次，这里会显示文件名），然后点击绿色的运行按钮（Play icon）。
使用快捷键： 按下 Shift+F10 (Windows/Linux) 或 Control+R (macOS)。

无论哪种方式，PyCharm 都会在窗口底部的 Run 工具窗口中打开一个新的选项卡，显示程序的输出：

“`
Hello, PyCharm User!

Process finished with exit code 0
“`

Process finished with exit code 0 表示程序正常结束。

第六步：调试您的代码

调试是找出和修复程序错误（bug）的关键技能。PyCharm 提供了非常强大的图形化调试器。

设置断点： 断点是您希望程序在执行过程中暂停的位置。在 hello.py 文件中，点击代码编辑器左侧的行号区域。例如，在 print(f"Hello, {name}!") 这一行的行号旁边点击一下。会出现一个红色的圆点，表示断点设置成功。
启动调试器：
- 在设置了断点的行旁边（或文件任意位置）右键点击。
- 选择 Debug ‘hello’。
- 或者点击旁边的绿色小三角形，选择 Debug ‘hello’。
- 或者在导航栏上选择当前的运行配置，点击调试按钮（Bug icon）。
- 使用快捷键 Shift+F9 (Windows/Linux) 或 Control+D (macOS)。

程序将开始执行，并在遇到断点时暂停。此时，PyCharm 会自动打开底部的 Debug 工具窗口。

熟悉调试工具窗口： Debug 工具窗口通常包含几个重要的面板：
- Frames: 显示当前的调用栈，即程序是如何一步步执行到当前位置的函数调用序列。
- Variables: 显示当前作用域内的所有变量及其值。您可以查看 user_name 和 name 的值。
- Console: 可以切换到 Debugger Console 选项卡，这是一个交互式的 Python 环境，您可以在程序暂停时执行任意 Python 表达式，检查变量值、调用函数等。
使用调试操作： 在 Debug 工具窗口顶部或主菜单的 Run 菜单下，有一系列调试控制按钮：
- Step Over (F10 / F8): 执行当前行的代码，如果当前行是一个函数调用，则跳过函数内部的执行，直接到函数调用后的下一行。
- Step Into (F11 / F7): 执行当前行的代码。如果当前行是一个函数调用，则进入该函数内部，暂停在函数的第一行可执行代码处。
- Step Out (Shift+F11 / Shift+F8): 从当前函数中退出，执行完当前函数剩余的代码，暂停在调用该函数的下一行。
- Run to Cursor (Alt+F9 / Option+F9): 将光标放在代码的某个位置，点击此按钮，程序将一直运行直到光标所在行（跳过期间的所有断点）。
- Resume Program (F9 / Cmd+R): 继续执行程序，直到遇到下一个断点或程序结束。
- Stop (Ctrl+F2 / Cmd+F2): 终止程序的执行。
继续调试： 使用 Step Over 或 Resume Program 按钮继续执行代码，观察变量值的变化，直到程序结束。

调试是提高开发效率的关键技能，花时间熟悉 PyCharm 的调试器将非常有益。

第七步：管理项目的 Python 包 (Package Management)

几乎所有的 Python 项目都会依赖于外部库（也称为包或模块），如 requests 用于网络请求，numpy 和 pandas 用于数据分析等。PyCharm 提供了方便的方式来管理这些项目依赖。

如前所述，我们建议为每个项目使用一个独立的虚拟环境。PyCharm 将包安装到当前项目的虚拟环境中，而不是全局 Python 环境。

打开 Python 解释器设置：
- 选择菜单 File > Settings… (Windows/Linux) 或 PyCharm > Preferences… (macOS)。
- 在弹出的设置窗口中，展开 Project: [您的项目名]。
- 选择 Python Interpreter。
在这里，您可以看到当前项目使用的 Python 解释器路径以及环境中已安装的包列表（通常刚创建的虚拟环境非常干净，只包含 pip, setuptools, wheel 等基础包）。
安装新包：
- 点击已安装包列表右侧的 + 按钮。
- 在弹出的 Available Packages 窗口中，可以通过搜索框查找您需要的包（例如输入 requests）。
- 选中找到的包（可以查看其版本信息和描述）。
- 点击窗口底部的 Install Package 按钮。PyCharm 会使用 pip 在当前项目的虚拟环境中下载并安装该包。
- 安装完成后，点击 Close 关闭窗口。新安装的包将出现在已安装包列表中。
升级或卸载包：
- 在 Python Interpreter 窗口的已安装包列表中，选中您想要操作的包。
- 点击列表下方的向上箭头按钮可以升级包到最新版本。
- 点击减号 – 按钮可以卸载选中的包。
使用 requirements.txt： 对于复杂的项目，通常会使用 requirements.txt 文件来列出项目的所有依赖。PyCharm 可以识别这个文件。
- 在项目根目录创建一个名为 requirements.txt 的文件。
- 在文件中列出项目依赖的包，每行一个，可选地指定版本号（例如 requests==2.28.1 或 numpy）。
- 当您打开 requirements.txt 文件时，PyCharm 顶部会显示一个黄色提示条，询问您是否安装文件中的所有依赖。点击 Install requirements 即可一键安装。

通过 PyCharm 的 Python Interpreter 设置，您可以方便地可视化管理项目依赖，这比在命令行中手动使用 pip 更加直观和便捷。

第八步：基本的版本控制集成 (以 Git 为例)

PyCharm Community Edition 支持与主流的版本控制系统集成，其中 Git 是最常用的。

启用版本控制集成：
- 如果您的项目之前已经是一个 Git 仓库（例如从 GitHub 克隆下来），PyCharm 通常会自动检测到。
- 如果您的项目是新建的，或者您想将一个现有项目添加到 Git 管理，选择菜单 VCS > Enable Version Control Integration…
- 在弹出的窗口中，选择 Git 作为版本控制系统，然后点击 OK。
- PyCharm 会在项目根目录创建一个 .git 文件夹，将项目初始化为一个 Git 仓库。
添加文件到 Git： 默认情况下，新创建的文件可能不会自动添加到 Git 跟踪。
- 在项目工具窗口中，新创建的文件名颜色可能是棕色的（表示未跟踪）。
- 右键点击文件（或文件夹），选择 Git > Add。文件名颜色会变成绿色（表示已添加到暂存区）。
提交更改 (Commit): 将已添加到暂存区的文件快照记录到本地仓库。
- 选择菜单 VCS > Commit… (或使用快捷键 Ctrl+K (Windows/Linux) / Cmd+K (macOS))。
- Commit 工具窗口会打开，显示已更改的文件列表。
- Version Control Tool Window: 或者，点击底部的 Version Control 工具窗口，选择 Local Changes 选项卡，在这里查看和选择要提交的文件。
- 在左侧的文本框中输入有意义的 Commit Message（提交信息），描述您本次提交做了哪些更改。
- 点击 Commit 按钮。PyCharm 会执行 Git commit 操作。
查看提交历史：
- 选择菜单 VCS > Git > Show History。
- 或者在项目工具窗口中，右键点击项目、文件夹或文件，选择 Git > Show History。
- Version Control Tool Window: 在 Version Control 工具窗口中，切换到 Log 选项卡，可以看到详细的提交历史。
推送 (Push) 和拉取 (Pull): 如果您的本地仓库关联了远程仓库（如 GitHub, Gitee），您可以在 PyCharm 中执行推送和拉取操作。
- Push: 选择菜单 Git > Push… (或使用快捷键 Ctrl+Shift+K (Windows/Linux) / Cmd+Shift+K (macOS))。在弹出的窗口中选择要推送的分支和远程仓库。
- Pull: 选择菜单 Git > Pull… (或使用快捷键 Ctrl+T (Windows/Linux) / Cmd+T (macOS))。在弹出的窗口中选择要拉取的分支和远程仓库。

虽然 PyCharm CE 的版本控制集成不像专业版那样提供一些高级功能（如可视化解决合并冲突可能需要借助外部工具），但它提供的基本操作对于日常的 Git 工作流程已经非常便利。

第三部分：PyCharm 实用技巧和功能探索

掌握了基本操作后，一些实用技巧可以进一步提升您的开发效率：

Search Everywhere (随处搜索): 快速查找文件、类、符号、配置项或运行命令的神器。连续按下两次 Shift 键即可打开搜索框。
Context Actions (上下文操作): 当 PyCharm 检测到您的代码可以进行某种改进或有快速解决方案时，会在代码旁边显示一个灯泡图标（通常是黄色的）。点击灯泡或按下 Alt+Enter (Windows/Linux) / Option+Enter (macOS)，会弹出一个菜单，提供各种上下文相关的操作，如导入模块、创建变量、生成代码、应用代码检查建议等。
Live Templates (实时模板): 输入一个缩写（如 pr 代表 print，fori 代表 for 循环），然后按下 Tab 键，即可快速生成一段代码模板。您还可以在设置中自定义 Live Templates。
Structure Tool Window (结构工具窗口): 通过 Alt+7 (Windows/Linux) / Cmd+7 (macOS) 打开。它显示当前文件的类、函数、方法等结构，方便您快速导航。
TODO Tool Window: 在代码中添加注释 # TODO: 或 # FIXME:，这些任务会收集到 TODO 工具窗口中，方便您跟踪未完成的工作。
终端工具窗口 (Terminal Tool Window): 通过 Alt+F12 (Windows/Linux) / Cmd+F12 (macOS) 打开。直接在 IDE 内部使用命令行，非常方便，且它会自动激活当前项目的虚拟环境。
快捷键： 熟练掌握 PyCharm 的快捷键可以显著提高效率。PyCharm 的 Keymap 设置中可以查找所有快捷键并进行自定义。一些常用快捷键：
- 运行: Shift+F10 / Control+R
- 调试: Shift+F9 / Control+D
- 提交: Ctrl+K / Cmd+K
- 格式化代码: Ctrl+Alt+L / Cmd+Option+L
- 重命名: Shift+F6
- 生成 (构造函数、方法等): Alt+Insert / Cmd+N
- 注释/取消注释行: Ctrl+/ / Cmd+/

结论

PyCharm Community Edition 作为一款免费且功能强大的 Python IDE，为开发者提供了智能的代码编辑、高效的调试工具、便捷的项目管理和版本控制集成。本文从 PyCharm CE 的介绍、与专业版的区别，到详细的入门步骤，涵盖了从安装、创建项目、编写代码、运行、调试、包管理到版本控制的基础操作。

虽然社区版在Web框架、科学计算等特定领域的功能不如专业版全面，但对于初学者和大部分日常 Python 开发任务来说，它已经绰绰有余。通过本文的引导，相信您已经能够开始使用 PyCharm CE 进行 Python 开发，并体会到 IDE 带来的便利。

编程是一个不断学习和实践的过程。鼓励您在掌握了这些基础后，继续探索 PyCharm 的更多功能，如更深入的代码检查、重构技巧、自定义设置以及各种有用的插件。利用好 PyCharm 提供的强大工具，将帮助您更高效、更愉快地进行 Python 开发。祝您编程愉快！