3.5.3 文件区¶

在 MicroPython 代码模式中，文件区分为**项目文件**和**主板文件**两部分，二者分工明确，共同支撑开发流程：

1. 项目文件

项目文件存储于电脑本地，是你开发过程中的工程文件集合。你可以在这里新建、打开、保存代码文件，随时修改、备份或管理整个项目，就像你的 “代码草稿本”。这些文件仅保存在电脑中，不会自动影响设备运行。

注意：

“项目文件”在MicroPytho积木模式和MicroPython代码模式中，有不同的定义，我们需要做一下区分。

模式	项目定义	保存格式	存储逻辑	注意事项
MicroPython积木模式	1 个项目 = 1 个 .mpcode压缩包	保存生成独立 mpcode 文件，打包封装全部积木代码 + 图片 / 音频等所有项目资源。	软件内部打包归档，项目是单独压缩文件。	常规保存直接生成 mpcode 即可。
MicroPython代码模式	项目 =本地电脑选定的文件夹	不再生成 mpcode 打包文件，所有文件以原始格式散落在项目文件夹内，逻辑同 VS Code（文件夹即项目）。	依托本地目录管理，代码、素材全部放在所选存本地文件夹中。	禁止直接选桌面等超大目录，需单独新建专属项目文件夹，把 mian.py、图片、音频等项目资源统一放入该文件夹后选中作为项目目录。、整盘

2. 主板文件

主板文件直接存储在连接的主控板（如行空板 K10、掌控板、ESP32）文件系统中，是设备上电后会直接读取并运行的程序文件，例如 boot.py（启动脚本）和 main.py（主程序）。你需要将项目文件上传到设备后，文件才会出现在这里，设备脱离电脑也能独立运行这些程序。

项目文件与主板文件的核心区别