

1. Python 文件(Python File)
✅ 最常用,绝对首选!
- 含义 :创建一个普通的 .py 源代码文件。
- 内容:空白的代码文件,你可以在里面写类、函数、逻辑,或者直接写脚本。
- 什么时候用?
- 新建一个窗口类(比如
channel_setting_dialog.py)。 - 新建一个业务逻辑文件(比如
can_sender.py)。 - 新建一个工具类(比如
utils.py)。 - 几乎 90% 的情况都选这个。
- 新建一个窗口类(比如
2. Python 单元测试(Python Unit Test)
🧪 专门写测试用例用的(后续有时间可以详细了解一下)
- 含义 :创建一个测试脚本文件,PyCharm 会自动帮你生成一套
unittest框架的模板代码。 - 内容 :自动生成
class 类名(unittest.TestCase):和def test_xxx(self):结构。 - 什么时候用?
- 当你写完代码,想专门验证它有没有 bug时。
- 比如你写完
can_bus.py,想测试发送报文功能正不正常,就新建一个Python Unit Test文件。 - 你的项目结构里
tests/文件夹下的文件,基本都是这种类型。

3. Python 存根(Python Stub)
📝 定义接口,不写实现(高级用法)
- 含义 :创建一个
.pyi后缀的文件。这是一种 "类型提示文件"。 - 内容 :里面通常只写类、函数名、参数类型,不写具体代码逻辑(没有 def 里面的内容)。
- 作用 :主要用于静态分析 和代码补全 。比如你定义了一个接口,但具体实现还没写,先用
.pyi文件告诉别人 "这里有个函数,参数是啥,返回是啥"。 - 什么时候用?
- 极不推荐你现在用。除非你在做复杂的框架开发、类型严格检查,或者你想定义抽象接口但暂时不写逻辑。
- 做普通的汽车电子测试工具,完全用不到。
⚡️ 超级总结(一张图看懂)
表格
| 选项 | 英文 | 核心作用 | 你的项目什么时候选它? |
|---|---|---|---|
| 1. Python 文件 | File | 写代码 / 建窗口 | 新建主窗口、新建弹窗、写业务逻辑、写工具类 |
| 2. Python 单元测试 | Unit Test | 测代码 | 写完某个功能后,写测试用例验证功能是否正常 |
| 3. Python 存根 | Stub | 定规范 / 留接口 | 不推荐。除非你要定义复杂的 API 契约,否则别用。 |