UNIX 和 Windows 端口的快速参考

命令行选项

用法:

micropython [ -h ] [ -i ] [ -O<level> ] [ -v ] [ -X <option> ] [ -c <command> | -m <module> | <script> ] [ <args> ]

调用选项:

-c <command>

中运行代码<command>。代码可以是一个或多个 Python 语句。

-m <module>

运行模块 <module>。该模块必须在sys.path.

<script>

运行文件<script>。该脚本必须是有效的 MicroPython 源代码文件。

如果上述 3 个选项均未给出,则 MicroPython 以交互式 REPL 模式运行。

<args>

模块或脚本之后的任何其他参数都将被传递到sys.argv (-c选项不支持)。

常规选项:

-h

打印包含命令行用法的帮助消息并退出。

-i

启用检查。设置此标志后,MicroPython 将在命令、模块或脚本完成后进入交互式 REPL 模式。这对于在未处理的异常之后调试状态很有用。另见MICROPYINSPECT环境变量。

-O | -O<level> | -OO...

设置优化级别。所述 O 可后跟一个数字或者可以重复多次,以指示电平。例如-O3,与 相同 -OOO

-v

增加详细级别。可以多次给出此选项。只有 MICROPY_DEBUG_PRINTERS 在编译 MicroPython 时启用此选项才有效。

-X <option>

指定其他特定于实现的选项。可能的选项是:

  • -X compile-only编译命令、模块或脚本但不运行它。

  • -X emit={bytecode,native,viper} 设置默认代码发射器。根据编译 MicroPython 时的设置,本机发射器可能不可用。

  • -X heapsize=<n>[w][K|M] 设置垃圾收集器的堆大小。后缀 w 表示字而不是字节。 K 表示 x1024 和M 表示 x1024x1024。

环境变量

MICROPYPATH

覆盖 MicroPython 库的默认搜索路径。MICROPYPATH 应设置为以冒号(Windows 端口为分号)分隔的目录列表。如果 MICROPYPATH未定义,则搜索路径将是 ~/.micropython/lib:/usr/lib/micropython (~/.micropython/lib对于 Windows 端口)或 MICROPY_PY_SYS_PATH_DEFAULT选项的值(如果它在 MicroPython 本身被编译时设置)。

MICROPYINSPECT

启用检查。如果 MICROPYINSPECT 设置为非空字符串,则与设置-i命令行选项的效果相同。