给 MicroPython 的模块添加类型提示，提升开发体验

MicroPython-Stubs 是一个比较新的、活跃的项目，旨在为 MicroPython 的模块添加 pyi 存根文件，从而为 MicroPython 提供类型提示支持。

安装#

这里我使用 uv 来管理依赖，当然 venv 也是可以的：

1
uv init
2
uv add micropython-esp32-stubs

配置编辑器#

Zed#

1
{
2
  "lsp": {
3
    "pyright": {
4
      "settings": {
5
        "python.analysis": {
6
          "extraPaths": [
7
            "./.venv/Lib/site-packages",
8
            "./.venv/lib/python3.12/site-packages",
9
            "./.venv/lib/python3.13/site-packages",
10
            "./.venv/lib/python3.14/site-packages"
11
          ],
12
          "typeCheckingMode": "basic",
13
          "diagnosticSeverityOverrides": {
14
            "reportMissingModuleSource": false
15
          }
16
        }
17
      }
18
    }
19
  }
20
}

VSCode#

1
{
2
  "python.analysis.extraPaths": [
3
    "./.venv/Lib/site-packages",
4
    "./.venv/lib/python3.12/site-packages",
5
    "./.venv/lib/python3.13/site-packages",
6
    "./.venv/lib/python3.14/site-packages"
7
  ],
8
  "python.analysis.typeCheckingMode": "basic",
9
  "python.analysis.diagnosticSeverityOverrides": {
10
    "reportMissingModuleSource": "none"
11
  }
12
}

跋#

经过如上配置后，编辑器就能识别 MicroPython 模块的类型提示了，从而提升代码的可读性和开发体验。希望本文对你有所帮助，祝你在 MicroPython 的开发旅程中一切顺利！