2、PyCharm：安装、配置与调试实战

工欲善其事，必先利其器。做 Python 开发，PyCharm 是我用得最顺手的 IDE，没有之一。尤其是搞包依赖管理的时候，PyCharm 的可视化界面能帮你省掉大量敲命令的时间。这一章咱们就把 PyCharm 从安装到调试捋一遍，全是干货。

2.1 安装 PyCharm

PyCharm 分两个版本：Community（社区版）和 Professional（专业版）。社区版免费，够用；专业版收费，但多了数据库工具、远程开发、Docker 支持等高级功能。我个人建议，如果你只是做 Python 包管理、写脚本、做数据分析，社区版完全够用。

安装步骤很简单：

1. 去 jetbrains.com/pycharm 下载对应系统的安装包
2. Windows 用户直接双击 .exe，记得勾选「Add to PATH」和「Create Desktop Shortcut」
3. macOS 用户拖到 Applications 文件夹就行
4. Linux 用户解压 tar.gz 后运行 bin/pycharm.sh

2.2 设置字体

写代码嘛，眼睛舒服最重要。PyCharm 默认的字体偏小，尤其是高分辨率屏幕下，看久了眼睛酸。我一般这么调：

操作路径： File → Settings → Editor → Font

参数	我的推荐值	说明
Font	JetBrains Mono / Fira Code	等宽字体，支持连字（ligatures）
Size	16	1080p 屏幕用 14-16，4K 屏建议 18-20
Line spacing	1.2	行距太密容易看串行

2.3 设置快捷键

PyCharm 的快捷键体系很强大，但默认的 Keymap 是 IntelliJ IDEA 风格，如果你从 VS Code 或 Sublime 转过来，会很不习惯。没关系，可以改。

操作路径： File → Settings → Keymap

我个人最常用的几个快捷键调整：

功能	默认快捷键	我改成的	说明
运行当前文件	Shift + F10	Ctrl + R	跟终端习惯一致
调试当前文件	Shift + F9	Ctrl + D	调试比运行更常用
搜索文件	Ctrl + Shift + N	Ctrl + P	单手操作更方便
格式化代码	Ctrl + Alt + L	不变	这个已经很顺手了

2.4 PyCharm 常用设置

除了字体和快捷键，还有几个设置我每次装完 PyCharm 必调。你想想看，这些设置能直接影响你的开发效率。

2.4.1 自动导入

路径： Editor → General → Auto Import

勾选「Add unambiguous imports on the fly」。这样你写 os.path.join 的时候，PyCharm 会自动帮你补全 import os，不用手动敲。

2.4.2 代码自动保存

路径： Appearance & Behavior → System Settings

勾选「Save files on frame deactivation」和「Save files automatically if application is idle for 15 seconds」。说白了就是切窗口或发呆时自动保存，防止丢代码。

2.4.3 显示行号和缩进线

路径： Editor → General → Appearance

勾选「Show line numbers」和「Show indent guides」。行号是调试必备，缩进线能帮你一眼看出代码块层级，尤其是写多层嵌套的时候。

2.4.4 虚拟环境配置

这个跟包依赖管理直接相关。PyCharm 创建新项目时，默认会帮你建一个虚拟环境。我建议你选「New environment using Virtualenv」，Python 版本选当前项目需要的版本。

# 在 PyCharm 终端里查看虚拟环境
pip list

# 导出依赖
pip freeze > requirements.txt

# 安装依赖
pip install -r requirements.txt

2.5 调试

调试是 PyCharm 的杀手锏。说实话，我见过太多人只会 print 大法，遇到复杂 bug 就抓瞎。PyCharm 的调试器能让你看到变量在每一行的变化，比 print 高效十倍。

2.5.1 设置断点

在代码行号旁边点一下，出现红色圆点就是断点。右键断点可以设置条件，比如「只在 i > 10 时暂停」。

2.5.2 启动调试

点击右上角的「小虫子」图标，或者按你设置的调试快捷键。程序会运行到第一个断点处暂停。

2.5.3 调试面板常用功能

按钮	快捷键	作用
Step Over	F8	单步执行，不进入函数内部
Step Into	F7	进入函数内部
Step Out	Shift + F8	跳出当前函数
Resume Program	F9	继续运行到下一个断点
Evaluate Expression	Alt + F8	在调试时执行任意表达式

2.5.4 调试包依赖问题

调试不光能查代码逻辑，还能查包依赖问题。比如你怀疑某个包的版本不对，可以在导入该包的地方设断点，然后看 __version__ 属性。

import requests

# 在下一行设断点
print(requests.__version__)  # 调试时看这个值是不是你想要的

我曾经遇到过一个坑：项目里同时装了 requests 2.25 和 2.28，因为虚拟环境混乱，导致实际用的是旧版。用调试器一看版本号，问题立刻暴露。

2.6 本章知识体系

下面这张图帮你梳理 PyCharm 的核心配置流程：

这张图把 PyCharm 的配置流程串起来了。从安装开始，到字体、快捷键、常用设置，最后落到调试。调试这块尤其重要，后面讲包依赖冲突排查时，你会经常用到它。