PyCharm 运行与调试最全实战指南（2025 版）
背会这篇，你以后再也不用 print(“=====到了这里=====”）来调试了！
1. 一键运行（3 种姿势，任选其一就行）
| 方式 | 操作 | 快捷键（Win/Linux） | Mac 快捷键 | 推荐指数 |
|---|---|---|---|---|
| 最快（临时运行） | 文件标签页右上角绿色小三角 ► | — | — | ★★★★★ |
| 标准（推荐） | 右键代码文件 → Run ‘xxx’ | Ctrl + Shift + F10 | Cmd + Shift + R | ★★★★★ |
| 永久运行配置（大项目） | 顶部 Run → Run… → Edit Configurations… | Shift + Alt + F10（选配置） | — | ★★★★☆ |
小技巧：
第一次运行后，PyCharm 会自动记住这个“运行配置”，以后直接点顶部绿色 ► 就行了！
2. 调试（Debug）才是 PyCharm 的灵魂！（比 print 高级 100 倍）
| 步骤 | 操作方式 | 说明 |
|---|---|---|
| 1. 打断点 | 在行号左侧点一下（出现红点） | 运行到这行就会暂停 |
| 2. 启动调试模式 | 点绿色小虫子（Debug） 或右键 → Debug ‘xxx’ | 快捷键：Shift + F9 |
| 3. 程序暂停后你能干的事 | ||
| 查看所有变量值 | 底部 Debugger 面板自动显示 | 鼠标悬停变量也能看 |
| 实时改变量值 | 右键变量 → Set Value…（F2） | 比如把 page=100 改成 1 继续跑 |
| 一步步执行 | F8（Step Over）跳到下一行 F7（Step Into）进入函数 Shift+F8 跳出函数 | 最常用 F8 |
| 条件断点（神技） | 右键红点 → Edit → Condition: i == 5 | 只有满足条件才停 |
| 临时执行代码（Evaluate） | Alt + F8 | 可以直接运行 requests.get() 看结果 |
| 直接跳到某个断点 | Ctrl + Shift + F8 → 查看所有断点 → 双击跳转 | 大项目必备 |
3. 常用运行配置（Run Configuration）技巧
点顶部 Run → Edit Configurations… 就能设置这些骚操作：
| 功能 | 设置位置 | 举例 |
|---|---|---|
| 运行时传参数 | Parameters | –env prod –port 8000 |
| 运行前先执行任务 | Before launch → + → Run Another Configuration | 先 pip install -r requirements.txt |
| 用不同 Python 解释器运行 | Python Interpreter 下拉菜单 | 同一个项目可以快速切 Python 3.11 / 3.12 |
| 多配置同时运行 | 点左上角 + → Compound | 同时启动 FastAPI + Celery + Redis |
| 运行覆盖率测试 | Modify options → Add Coverage | 看哪些代码没测到 |
4. 终端 vs Run 窗口区别（很多人搞混）
| 窗口 | 特点 | 适合场景 |
|---|---|---|
| Run 窗口 | PyCharm 管理，颜色高亮，支持点击跳转 | 看日志、异常堆栈、点击跳到报错行 |
| Terminal 窗口 | 完整 bash/powershell，交互性强 | pip install、git、python -m xxx |
5. 实战小例子（3 分钟让你爱上调试）
新建 debug_test.py：
import time
for i in range(1, 101):
print(f"正在处理第 {i} 个用户...")
if i == 50:
print("这里有 bug！")
raise ValueError("测试异常")
time.sleep(0.1)操作流程：
- 第 5 行打断点（红点）
- 点 Debug（小虫子）
- 程序停在第 5 行 → 点 F8 一行行往下走
- 在 Variables 里右键 i → Set Value → 改成 99
- 点 Resume（F9）直接跳到最后
你会发现：根本不用改代码，就能瞬间跳过 50→99，调试速度暴涨！
6. 必开设置（让调试更爽）
Settings → Build, Execution, Deployment → Debugger：
- [√] Show return values（函数返回值直接显示）
- [√] Focus on breakpoint（断点时自动跳到编辑器）
- [√] Enable ‘toString()’ object view（支持自定义 repr）
一句话总结
- 普通运行 → 绿色三角 ►
- 认真调试 → 绿色虫子 bug（Shift + F9）+ F8 + Alt + F8
- 永远不要再用 print 调试了！
现在就去你项目里随便打 3 个断点，用 Debug 模式跑一遍，你会立刻感受到 PyCharm 为什么被称作“Python 神器”！
有任何调试问题（比如进不去断点、变量看不见、远程调试不会、多进程卡住），直接把代码+现象发我，我 1 分钟帮你解决！Go debug！
