UNIX 和 Windows Port 的快速参考



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


-c <command>

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

-m <module>

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


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

If none of the 3 options above are given, then MicroPython is run in an interactive REPL mode.


Any additional arguments after the module or script will be passed to sys.argv (不支持采用 -c 选项)。





Enables inspection. When this flag is set, MicroPython will enter the interactive REPL mode after the command, module or script has finished. This can be useful for debugging the state after an unhandled exception. Also see the MICROPYINSPECT 环境变量。

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

设置优化级别。 O can be followed by a number or can be repeated multiple times to indicate the level. E.g. -O3 如同 -OOO .


Increases the verbosity level. This option can be given multiple times. This option only has an effect if MICROPY_DEBUG_PRINTERS was enabled when MicroPython itself was compiled.

-X <option>

Specifies additional implementation-specific options. Possible options are:

  • -X compile-only compiles the command, module or script but does not run it.

  • -X emit={bytecode,native,viper} sets the default code emitter. Native emitters may not be available depending on the settings when MicroPython itself was compiled.

  • -X heapsize=<n>[w][K|M] sets the heap size for the garbage collector. The suffix w means words instead of bytes. K means x1024 and M means x1024x1024.



Overrides the default search path for MicroPython libraries. MICROPYPATH should be set to a colon (semicolon for Windows port) separated list of directories. If MICROPYPATH is not defined, the search path will be ~/.micropython/lib:/usr/lib/micropython ( ~/.micropython/lib for Windows port) or the value of the MICROPY_PY_SYS_PATH_DEFAULT option if it was set when MicroPython itself was compiled.


启用审查。若 MICROPYINSPECT is set to a non-empty string, it has the same effect as setting the -i 命令行选项。