📚 课程目录第2章开发环境搭建

2、PyCharm 安装与调试技巧归纳总结

说实话，工欲善其事必先利其器。PyCharm 这玩意儿，用得好是神器，用不好就卡得你怀疑人生。我最早用的时候也踩过不少坑——装好了发现解释器配错了，调试了半天发现压根没进断点……嗯，这一章我把那些经验教训整理出来，你照着来，至少能省半天功夫。

PyCharm 分 Professional 和 Community 两个版本。咱们做 Python MD 批处理质控，Community 版完全够用，除非你要连数据库或远程调试。我个人习惯用 Community，轻量、免费，还不用担心许可证过期。

提示： 如果公司给配了专业版，那更好。但别装太多插件，否则启动慢得像老牛拉车。

安装没啥难度，从 JetBrains 官网下载对应系统的安装包就行。我碰到的坑是 macOS 上直接拖 Application 文件夹，但第一次启动会弹安全警告。解决办法就一个：去系统设置里允许“任何来源”的应用，或者右键打开。

推荐配置：

项目创建的第一步就是选解释器。你想想看，如果解释器选成了系统自带 Python，后面装包乱成一锅粥。我建议直接用 虚拟环境，每个项目独立。

新建项目时，PyCharm 会给两个选项：
• New environment using Virtualenv – 默认创建独立虚拟环境
• Existing interpreter – 用已有的，比如 Conda 环境

咱们做质控脚本，推荐用 Virtualenv，干净利落。创建后会自动激活，终端里前面会有 (venv) 前缀。

注意： 不要手动删掉项目根目录下的 venv 文件夹，不然 PyCharm 会报找不到解释器。曾经有一位同事删了之后重装了一下午的包。

分享一下我的做法：项目创建完第一件事就是打开终端，执行 pip install -r requirements.txt（如果有的话）。如果没有，先装最核心的：pandas、re、os、sys 这些。咱们 MD 批处理用到的第三方库不多，但最好统一版本。

pip install pandas openpyxl  # 处理 Excel 表格
pip install matplotlib       # 后期可视化用

用 PyCharm 不背快捷键，就像开车只用脚刹——能走但累得慌。我列个常用列表，你存一下。

我最常用的其实是 Alt + 1 切换项目视图、Ctrl + Tab 切换文件。你慢慢记，不用一天背完。

调试这东西，说白了就是让代码一步一步走，看哪里不对劲。我刚开始做质控脚本时，遇到大文件处理慢，死活查不出原因。后来发现是正则匹配写了个贪婪模式，字符串匹配了整块文本。嗯，要是没有调试，我可能还在用打印大法。

在行号后面点一下，出现红色圆点就是断点。右键断点可以设置条件，比如只在某个变量等于特定值时才暂停。我处理 MD 文件批处理时经常这样用：

def process_file(file_name):
    # 我想只调试文件名包含 "error" 的文件
    print(f"Processing {file_name}")
    # 在下一行打条件断点：'error' in file_name

技巧： 右键断点选 More，可以设置 Pass count（跳过前 N 次）、Log message to console（不暂停只打印）。这对于循环中的调试特别有用，省得你一遍遍按 F9。

调试过程中，按 Alt + F8（Win） 或 Option + F8（Mac），可以弹出计算器。随时查看变量值或者调用函数。我曾经用这个快速验证一段字符串的正则匹配结果，不用写临时代码。

# 在调试窗口输入
re.findall(r'\d+\.\d+', current_line)

你想想看，比写 print() 再删省事多了。

启动调试后，下方会出现 Debugger 面板。从左到右几个核心区域：

我最常用的是 Watches。处理 MD 文件时，经常要看 len(lines)、current_section 这些，加进去就不用反复看变量列表。

曾经踩过的坑： 一次我调试多线程脚本，断点打在线程内部，结果发现每次停的位置不一样，线程变量共享乱套了。这才意识到调试时尽量在主线程打断点，多线程调试要用 All threads 模式，并且注意同步锁。嗯，多线程调试是另一个知识点了，这里先不提。

下面这张图把本章的核心内容串起来，你一眼就能看清调试的完整路径。

我挑几个新手最容易翻车的地方，你记一下。

问题一：控制台不显示输出

最可能的原因——代码里用了 print()，但调试模式下的控制台输出被缓冲了。解决办法：在 Run/Debug Configurations 里加上环境变量 PYTHONUNBUFFERED=1。

问题二：断点打不中

我曾经花了半小时才发现自己编辑的是 class.py，但运行的是 class.pyc 缓存文件。或者在虚拟环境外的副本上调试。解决方法：右键点击项目根目录，选择 Mark Directory as → Sources Root，确保运行配置里入口文件路径正确。

问题三：变量显示为 <unavailable>

一般出现在循环结束之后，或者变量被优化掉了。可以在断点前先用 locals() 或者临时赋值给一个列表，就能看到了。

另外，调试时如果程序卡死，别急着关 PyCharm，先点左下角的红色方块 Stop 按钮。强行关掉再开，有时候会导致配置丢失。

嗯，关于 PyCharm 的安装与调试技巧，这些够你上手了。记住：调试不是遇到 bug 才用，写代码的时候开着调试跑一遍，能提前发现很多逻辑漏洞。咱们做 MD 批处理，数据量大、流程长，调试就是你的第二双眼睛。