4.1 准备可调试的开发环境
前置知识：第3章（Git 与版本控制）
预计时间：10 分钟
练习环境：Python 3 与支持 Python 调试的 IDE；界面名称可能随版本变化
完成标志：IDE 使用正确的项目根目录、解释器和调试配置
调试器要停在你正在阅读的那份代码上，才能解释变量为什么出错。先用只有一行的程序核对入口、解释器和工作目录，再调试业务逻辑。断点没命中，常见原因不是 IDE 坏了，而是目录、入口、解释器或源码版本对不上。
选择工具看项目约束
VS Code 是可扩展编辑器，调试能力由语言扩展和调试适配器提供；IntelliJ IDEA 以 JVM 项目能力见长，其他语言支持取决于版本和插件。团队已有配置、目标语言、远程环境和许可证，比“哪个 IDE 最强”更值得优先考虑。
界面会更新，本页不固定插件按钮位置。安装来源应是 IDE 官方市场或组织批准的渠道，并检查发布者、权限和维护状态。
创建隔离项目
bash
python3 --version
workdir=$(mktemp -d)
mkdir -p "$workdir/debug-workshop"
cd "$workdir/debug-workshop"
printf '%s\n' 'print("hello workshop")' > hello_workshop.py
python3 hello_workshop.py用 IDE 打开 debug-workshop 目录，而不是只打开单个文件。确认：
- 状态栏或项目设置选择了预期 Python 解释器。
- 集成终端中的
python3与调试配置指向同一环境，或明确知道两者为何不同。 - 运行入口是
hello_workshop.py，工作目录是项目根目录。 - 普通运行能稳定输出，再切换调试模式。
VS Code 的 Python 调试由 Microsoft 的 Python 与 Python Debugger 扩展提供；IntelliJ/PyCharm 的 Python 能力取决于产品与插件。Java 项目则应核对项目 SDK、模块和构建工具导入状态。安装前仍要检查扩展发布者，不要只看相似名称。
第一个断点
在 print 行的行号边栏设置断点，以 Debug 模式启动当前文件。若断点显示未绑定，先检查运行目标、解释器和源文件映射，不要改业务代码。
清理练习：
bash
cd
ls -ld -- "$workdir"
rm -r -- "$workdir"界面步骤变化时，以 VS Code 的 Python 调试文档 或当前 IDE 的官方手册为准。