元数据卡

• 前置知识：第3章（Git 基本操作）
• 预计时间：10 分钟
• 阅读模式：快速浏览
• 完成标志：能在 VS Code 或 IntelliJ 中创建项目并找到文件

你的进度

你还在出发前的工坊里。Git 的时光机教会了你如何来回穿梭，但代码跑起来结果不对——它没报错，它就是算错了。或者更糟——它有时候对，有时候错，完全看心情。

你盯着屏幕上的代码——一行行检查。"这不挺对的吗？怎么跑出来就是乱的呢？"

这时候，你需要的不是更专注的眼睛，而是一台 显微镜。

但在这之前，你至少需要一个能架起这台显微镜的操作台。

---

选一把好钳子：VS Code 还是 IntelliJ？

工坊里总有两派人——用多功能钳的，和用专用精密套件的。对应的编辑器世界也一样：

维度	VS Code	IntelliJ IDEA
定位	轻量代码编辑器	全功能 IDE
开箱	基础编辑，靠插件扩展	内置全套开发工具
适合	Python / JS / TS / Go / Rust	Java / Kotlin / 大型企业项目
内存	省（~300MB）	占（~1GB+）
调试	插件驱动，Python 需装 Python 扩展	自带 Java 调试，装插件可调试 Python

怎么选？

学习阶段选 VS Code——轻、快、灵活。等你写 Java 的中大型项目再切 IntelliJ。

你现在就装 VS Code，加两个扩展就够了：

• Python（Microsoft 官方）——代码补全、调试、linting 一条龙
• GitLens——把 Git blame / history 嵌进编辑器里

---

创建第一个项目

你面前的工坊需要一扇门。IDE 下项目就是这个门——它知道你的代码归哪堆。

在 VS Code 里：

1. 按 Ctrl+Shift+P → 输入 Python: Create Environment → 选择 venv
2. `Ctrl+`` 打开终端，试试你的第一个文件

假设你创建一个文件 hello_workshop.py：

# hello_workshop.py
def greet(name):
    return f"欢迎来到工坊，{name}！"

print(greet("新学徒"))

语言： Python 3 如何运行： 在 VS Code 终端输入 python hello_workshop.py预期输出：

欢迎来到新学徒，工坊！

（等等，顺序好像不太对……别急，下一节我们就用调试器找出这种问题。）

---

在文件森林里认路

一个项目常常有几十个文件。你在工坊里不可能把每把锉刀都摆桌上——你需要分类架。

VS Code 左边的 资源管理器（Explorer） 就是你的分类架：

📁 project-root/
  ├── 📁 src/          ← 源代码放这里
  │   ├── forge.py      — 锻造逻辑
  │   └── quench.py     — 淬火算法
  ├── 📁 tests/         ← 测试代码
  ├── 📁 data/          ← 测试数据（CSV / JSON）
  ├── requirements.txt  ← 依赖清单
  └── README.md         ← 说明文档

要点：

• Ctrl+P 快速跳转文件——输入文件名就能定位，不用手动展开目录
• Ctrl+Shift+E 切到资源管理器
• 右键文件夹 → "在终端中打开" 直接开一个终端到对应目录

文件导航不是为了好看——它让你在调试时能飞速定位到问题文件。

---

→ 下一站

操作台搭好了，该架显微镜了。下一份档案教你如何用断点冻住程序、逐行步进观察变量——IDE 调试器基础。