このドキュメンテーションは、MicroPython の最新開発ブランチのためのものです。リリースバージョンでは利用できない機能に言及することがあります。

特定のリリースのドキュメントをお探しの場合は、左側のドロップダウンメニューを使って、望みのバージョンを選択します。

コア言語

Generated Sat 08 Aug 2026 01:23:30 UTC

クラス

特殊メソッド del はユーザ定義クラス用には未実装

サンプルコード:

import gc

class Foo:
    def __del__(self):
        print("__del__")

f = Foo()
del f

gc.collect()

CPython 出力:	MicroPython 出力
__del__

dir() は dir の戻り値をソート済みリストに変換しない

原因: MicroPython の dir() 関数は、__dir__ の値をリストに反復処理したりソートしたりせずに、そのまま返します。

回避策: __dir__ でソート済みのリストを直接返すようにしてください。

サンプルコード:

class C:
    def __dir__(self):
        return "cba"


print(dir(C()))

CPython 出力:	MicroPython 出力
['a', 'b', 'c']	cba

`__init_subclass__` は自動的に呼び出されない。

原因: MicroPython は現在 PEP 487 を実装していません。

回避策: 必要に応じて、クラス作成後に __init_subclass__ を手動で呼び出してください。例:

class A(Base):
    pass
A.__init_subclass__()

サンプルコード:

class Base:
    @classmethod
    def __init_subclass__(cls):
        print(f"Base.__init_subclass__({cls.__name__})")


class A(Base):
    pass

CPython 出力:	MicroPython 出力
Base.__init_subclass__(A)

`__init_subclass__` は暗黙的なクラスメソッドではない。

原因: MicroPython は現在 PEP 487 を実装していません。 __init_subclass__ は現在、特別扱いのクラス/静的メソッドのリストに含まれていません。

回避策: __init_subclass__ の宣言に @classmethod アノテーションを付けてください。

サンプルコード:

def regularize_spelling(text, prefix="bound_"):
    # 束縛されたクラスメソッドの型に対する CPython の "method" と MicroPython の "bound_method" という表記の違いを吸収するため
    if text.startswith(prefix):
        return text[len(prefix) :]
    return text


class A:
    def __init_subclass__(cls):
        pass

    @classmethod
    def manual_decorated(cls):
        pass


a = type(A.__init_subclass__).__name__
b = type(A.manual_decorated).__name__

print(regularize_spelling(a))
print(regularize_spelling(b))
if a != b:
    print("FAIL")

CPython 出力:	MicroPython 出力
method method	function method FAIL

MicroPython は、パラメータ化 `__init_subclass__` クラスカスタマイズをサポートしていない

原因: MicroPython は現在 PEP 487 を実装していません。MicroPython の構文ツリーには、クラス継承リストの後に kwargs ノードが含まれていません。

回避策: クラス変数または別のメカニズムを使用して、基底クラスのカスタマイズを指定してください。

サンプルコード:

class Base:
    @classmethod
    def __init_subclass__(cls, arg=None, **kwargs):
        cls.init_subclass_was_called = True
        print(f"Base.__init_subclass__({cls.__name__}, {arg=!r}, {kwargs=!r})")


class A(Base, arg="arg"):
    pass


# MicroPython が __init_subclass__ を自動的に呼び出さない点も吸収します。
if not getattr(A, "init_subclass_was_called", False):
    A.__init_subclass__()

CPython 出力:	MicroPython 出力
Base.__init_subclass__(A, arg='arg', kwargs={})	Traceback (most recent call last): File "<stdin>", line 16, in <module> TypeError: function doesn't take keyword arguments

`__init_subclass__` は協調-再帰的な方法で定義することはできない。

原因: MicroPython は現在 PEP 487 を実装していません。基本オブジェクト型に __init_subclass__ の実装がありません。

回避策: 祖父母クラスにも __init_subclass__ が定義されていることがわかっている場合を除き、再帰的な __init_subclass__ 呼び出しを省略してください。

サンプルコード:

class Base:
    @classmethod
    def __init_subclass__(cls, **kwargs):
        cls.init_subclass_was_called = True
        super().__init_subclass__(**kwargs)


class A(Base):
    pass


# MicroPython が __init_subclass__ を自動的に呼び出さない点も吸収します。
if not getattr(A, "init_subclass_was_called", False):
    A.__init_subclass__()

CPython 出力:	MicroPython 出力
	Traceback (most recent call last): File "<stdin>", line 22, in <module> File "<stdin>", line 13, in __init_subclass__ AttributeError: 'super' object has no attribute '__init_subclass__'

メソッド解決順序(MRO: Method Resolution Order)は Cpython に未準拠

原因: 深さ優先の非網羅的なメソッド解決順序

回避策: 多重継承と複雑なメソッドのオーバーライドがある複雑なクラス階層を避ける。多くの言語が多重継承をまったくサポートしていないことに留意。

サンプルコード:

class Foo:
    def __str__(self):
        return "Foo"


class C(tuple, Foo):
    pass


t = C((1, 2, 3))
print(t)

CPython 出力:	MicroPython 出力
Foo	(1, 2, 3)

プライベートなクラスメンバーの名前のマングリングは未実装

原因: MicroPython コンパイラはプライベートクラスメンバーの名前のマングリングを実装していない。

回避策: グローバル名との衝突を避けるため、手動でプライベートクラスメンバー名に一意のプレフィックスを追加してください。

サンプルコード:

def __print_string(string):
    print(string)


class Foo:
    def __init__(self, string):
        self.string = string

    def do_print(self):
        __print_string(self.string)


example_string = "Example String to print."

class_item = Foo(example_string)
print(class_item.string)

class_item.do_print()

CPython 出力:

MicroPython 出力

Example String to print.
Traceback (most recent call last):
  File "<stdin>", line 26, in <module>
  File "<stdin>", line 18, in do_print
NameError: name '_Foo__print_string' is not defined. Did you mean: '__print_string'?

Example String to print.
Example String to print.

`str` が文字列型以外の型を返しても TypeError は発生しない

原因: MicroPython の instance_print は __str__ または __repr__ が str またはそのサブクラスを返すことを検証しません。

回避策: __str__ と __repr__ が常に str インスタンスまたはそのサブクラスを返すようにしてください。

サンプルコード:

class Foo:
    def __str__(self):
        return True


print(str(Foo()))

CPython 出力:	MicroPython 出力
Traceback (most recent call last): File "<stdin>", line 14, in <module> TypeError: __str__ returned non-string (type bool)	True

str() は `str` または `repr` の戻り値から str サブクラスの型を保持しない

原因: 実装上 __str__ または __repr__ によって返される str サブクラス型が破棄され、str() からは常にプレーンな str インスタンスが返されます。

"回避策: str() が str サブクラス型を保持することに依存しないでください。

サンプルコード:

class MyStr(str):
    pass


class Foo:
    def __str__(self):
        return MyStr("abc")


result = str(Foo())
print(type(result))

CPython 出力:	MicroPython 出力
<class '__main__.MyStr'>	<class 'str'>

ネイティブ型を継承する場合 `init(self, ...)` 内で `super().init()` より前にメソッドを呼び出すと、 `AttributeError` が発生する(`MICROPY_BUILTIN_METHOD_CHECK_SELF_ARG` が有効になっていない場合はセグメンテーション違反が発生する)。

原因: MicroPython のネイティブ型には __new__ メソッドと __init__ メソッドが別々に用意されていません。

回避策: 最初に super().__init__() を呼び出してください。

サンプルコード:

class L1(list):
    def __init__(self, a):
        self.append(a)


try:
    L1(1)
    print("OK")
except AttributeError:
    print("AttributeError")


class L2(list):
    def __init__(self, a):
        super().__init__()
        self.append(a)


try:
    L2(1)
    print("OK")
except AttributeError:
    print("AttributeError")

CPython 出力:	MicroPython 出力
OK OK	AttributeError OK

多重継承では super() は１つのクラスを呼び出すだけ

原因: メソッド解決順序(MRO: Method Resolution Order)は Cpython に未準拠を参照

回避策: メソッド解決順序(MRO: Method Resolution Order)は Cpython に未準拠を参照

サンプルコード:

class A:
    def __init__(self):
        print("A.__init__")


class B(A):
    def __init__(self):
        print("B.__init__")
        super().__init__()


class C(A):
    def __init__(self):
        print("C.__init__")
        super().__init__()


class D(B, C):
    def __init__(self):
        print("D.__init__")
        super().__init__()


D()

CPython 出力:	MicroPython 出力
D.__init__ B.__init__ C.__init__ A.__init__	D.__init__ B.__init__ A.__init__

サブクラスでの super() ゲッター(getter)プロパティ呼出しは、値ではなくプロパティオブジェクトを返す

サンプルコード:

class A:
    @property
    def p(self):
        return {"a": 10}


class AA(A):
    @property
    def p(self):
        return super().p


a = AA()
print(a.p)

CPython 出力:	MicroPython 出力
{'a': 10}	<property>

例外

派生例外クラスのインスタンスにおいて、最初に `super().init` を呼び出さずに init 内で raise すると `TypeError` になる

原因: MicroPython では、オブジェクトがスーパークラスの init 関数を呼び出さない場合、または __init__ メソッドから正常に戻らない場合、オブジェクトは不完全に構築されます。このため、状況によってはオブジェクトを使用できなくなることがあります。

回避策: 例外を発生させる前に、スーパークラスの __init__ メソッドを呼び出してください。

サンプルコード:

class C(Exception):
    def __init__(self):
        raise self


class C1(Exception):
    def __init__(self):
        super().__init__()
        raise self


try:
    C()
except Exception as e:
    print(type(e).__name__)

try:
    C1()
except Exception as e:
    print(type(e).__name__)

CPython 出力:	MicroPython 出力
C C1	TypeError C1

関数

メソッドのエラーメッセージは予期しない引数の数を表示する

原因: MicroPython は引数として "self" をカウントしている。

回避策: 上記の情報を念頭に置いてエラーメッセージを解釈。

サンプルコード:

try:
    [].append()
except Exception as e:
    print(e)

CPython 出力:	MicroPython 出力
list.append() takes exactly one argument (0 given)	function takes 2 positional arguments but 1 were given

"関数オブジェクトは `module` 属性を持たない

原因: MicroPython は RAM 使用量について最適化しています。

回避策: 非組込みモジュールについては sys.modules[function.__globals__['__name__']] を使う。

サンプルコード:

def f():
    pass


print(f.__module__)

CPython 出力:	MicroPython 出力
__main__	Traceback (most recent call last): File "<stdin>", line 13, in <module> AttributeError: 'function' object has no attribute '__module__'

`*args` はキーワード引数の後に続くことはできない

原因: MicroPython はコードスペースを最適化しています。詳細はこの問題を参照してください。

回避策: 引数の順序を変更してください。

サンプルコード:

def f(x, y):
    return x + y


try:
    print(f(y=1, *(3,)))
except Exception as e:
    print(e)

CPython 出力:	MicroPython 出力
4	Traceback (most recent call last): File "<stdin>", line 14, in <module> SyntaxError: * arg after kwarg

関数のユーザ定義属性はサポートしていない

原因: MicroPython はメモリ使用量について高度に最適化しています。

回避策: 外部辞書を使う。たとえば FUNC_X[f] = 0 とするなど。

サンプルコード:

def f():
    pass


f.x = 0
print(f.x)

CPython 出力:	MicroPython 出力
0	Traceback (most recent call last): File "<stdin>", line 13, in <module> AttributeError: 'function' object has no attribute 'x'

ジェネレータ

コンテキストマネージャーの exit() は完了まで実行されないジェネレータでは呼び出されない

サンプルコード:

class foo(object):
    def __enter__(self):
        print("Enter")

    def __exit__(self, *args):
        print("Exit")


def bar(x):
    with foo():
        while True:
            x += 1
            yield x


def func():
    g = bar(0)
    for _ in range(3):
        print(next(g))


func()

CPython 出力:	MicroPython 出力
Enter 1 2 3 Exit	Enter 1 2 3

ランタイム

ローカル変数は locals() の結果に含まれない

原因: MicroPython はシンボリックローカル環境を維持せず、スロットの配列に最適化されています。したがって、ローカル変数には名前でアクセスできません。

サンプルコード:

def test():
    val = 2
    print(locals())


test()

CPython 出力:	MicroPython 出力
{'val': 2}	{'test': <function test at 0x9bb006260>, '__name__': '__main__', '__file__': '<stdin>'}

eval() 関数で実行されるコードはローカル変数にアクセスできない

原因: MicroPython はシンボリックローカル環境を維持せず、スロットの配列に最適化されています。したがって、ローカル変数には名前でアクセスできません。効果的に、MicroPython の eval(expr) は eval(expr, globals(), globals()) と同等です。

サンプルコード:

val = 1


def test():
    val = 2
    print(val)
    eval("print(val)")


test()

CPython 出力:	MicroPython 出力
2 2	2 1

f-strings

f-strings は、隣接するリテラルに中括弧が含まれている場合、隣接するリテラルとの連結をサポートしない

原因: MicroPython はコードスペースを最適化しています。

回避策: リテラル文字列同士が f-strings でない場合は、+ 演算子を使ってください。

サンプルコード:

x, y = 1, 2
print("aa" f"{x}")  # 動作します
print(f"{x}" "ab")  # 動作します
print("a{}a" f"{x}")  # 失敗します
print(f"{x}" "a{}b")  # 失敗します

CPython 出力:	MicroPython 出力
aa1 1ab a{}a1 1a{}b	aa1 1ab Traceback (most recent call last): File "<stdin>", line 12, in <module> IndexError: tuple index out of range

f-strings は、不均衡な入れ子になった中括弧や角括弧を解決するために解析を必要とする式をサポートできない

原因: MicroPython はコードスペースを最適化しています。

回避策: f-strings 内の式では、常にバランスの取れた中括弧と角括弧を使用してください。

サンプルコード:

print(f"{'hello { world'}")
print(f"{'hello ] world'}")

CPython 出力:	MicroPython 出力
hello { world hello ] world	Traceback (most recent call last): File "<stdin>", line 9 SyntaxError: invalid syntax

f-strings は !a 変換をサポートしていない

原因: MicropPython は ascii()を実装していません。

回避策: なし

サンプルコード:

f"{'unicode text'!a}"

CPython 出力:	MicroPython 出力
	Traceback (most recent call last): File "<stdin>", line 8 SyntaxError: invalid syntax

import

パッケージの path 属性は、MicroPython では異なるデータ型を持つ(文字列のリストではなく、単一の文字列)

原因: MicroPython はファイルシステム間で分割された名前空間パッケージをサポートしていません。それを踏まえ、MicroPython の import システムは、メモリ使用量を最小限に抑えるために高度に最適化されています。

回避策: import 処理の詳細は、本質的に実装に依存する。ポータブルアプリケーションでこのような詳細に頼らないことようにする。

サンプルコード:

import modules

print(modules.__path__)

CPython 出力:	MicroPython 出力
['/Volumes/bufext/work/mpy/micropython/tests/cpydiff/modules']	../tests/cpydiff/modules

MicroPythonはファイルシステムをまたぐ名前空間パッケージには対応していない。

原因: MicroPython の import システムは、シンプルさ、最小限のメモリ使用量、最小のファイルシステム検索オーバーヘッドのために高度に最適化されている。

回避策: 同じ名前空間のパッケージに属するモジュールを、異なるディレクトリにインストールしないこと。MicroPythonでは最大で3つのコンポーネントのモジュール検索パスを持つことが推奨されている: 現在のアプリケーション用、ユーザーごと(書き込み可能)、システム全体(書き込み不可)。

サンプルコード:

import sys

sys.path.append(sys.path[1] + "/modules")
sys.path.append(sys.path[1] + "/modules2")

import subpkg.foo
import subpkg.bar

print("Two modules of a split namespace package imported")

CPython 出力:	MicroPython 出力
Two modules of a split namespace package imported	Traceback (most recent call last): File "<stdin>", line 14, in <module> ImportError: no module named 'subpkg.bar'

コア言語

クラス

特殊メソッド __del__ はユーザ定義クラス用には未実装

dir() は __dir__ の戻り値をソート済みリストに変換しない

__init_subclass__ は自動的に呼び出されない。

__init_subclass__ は暗黙的なクラスメソッドではない。

MicroPython は、パラメータ化 __init_subclass__ クラスカスタマイズをサポートしていない

__init_subclass__ は協調-再帰的な方法で定義することはできない。

メソッド解決順序(MRO: Method Resolution Order)は Cpython に未準拠

プライベートなクラスメンバーの名前のマングリングは未実装

__str__ が文字列型以外の型を返しても TypeError は発生しない

str() は __str__ または __repr__ の戻り値から str サブクラスの型を保持しない

ネイティブ型を継承する場合 __init__(self, ...) 内で super().__init__() より前にメソッドを呼び出すと、 AttributeError が発生する(MICROPY_BUILTIN_METHOD_CHECK_SELF_ARG が有効になっていない場合はセグメンテーション違反が発生する)。

多重継承では super() は１つのクラスを呼び出すだけ

サブクラスでの super() ゲッター(getter)プロパティ呼出しは、値ではなくプロパティオブジェクトを返す

例外

派生例外クラスのインスタンスにおいて、最初に super().__init__ を呼び出さずに __init__ 内で raise すると TypeError になる

関数

メソッドのエラーメッセージは予期しない引数の数を表示する

"関数オブジェクトは __module__ 属性を持たない

*args はキーワード引数の後に続くことはできない

関数のユーザ定義属性はサポートしていない

ジェネレータ

コンテキストマネージャーの __exit__() は完了まで実行されないジェネレータでは呼び出されない

ランタイム

ローカル変数は locals() の結果に含まれない

eval() 関数で実行されるコードはローカル変数にアクセスできない

f-strings

f-strings は、隣接するリテラルに中括弧が含まれている場合、隣接するリテラルとの連結をサポートしない

f-strings は、不均衡な入れ子になった中括弧や角括弧を解決するために解析を必要とする式をサポートできない

f-strings は !a 変換をサポートしていない

import

パッケージの __path__ 属性は、MicroPython では異なるデータ型を持つ(文字列のリストではなく、単一の文字列)

MicroPythonはファイルシステムをまたぐ名前空間パッケージには対応していない。

特殊メソッド del はユーザ定義クラス用には未実装

dir() は dir の戻り値をソート済みリストに変換しない

`__init_subclass__` は自動的に呼び出されない。

`__init_subclass__` は暗黙的なクラスメソッドではない。

MicroPython は、パラメータ化 `__init_subclass__` クラスカスタマイズをサポートしていない

`__init_subclass__` は協調-再帰的な方法で定義することはできない。

`str` が文字列型以外の型を返しても TypeError は発生しない

str() は `str` または `repr` の戻り値から str サブクラスの型を保持しない

ネイティブ型を継承する場合 `init(self, ...)` 内で `super().init()` より前にメソッドを呼び出すと、 `AttributeError` が発生する(`MICROPY_BUILTIN_METHOD_CHECK_SELF_ARG` が有効になっていない場合はセグメンテーション違反が発生する)。

派生例外クラスのインスタンスにおいて、最初に `super().init` を呼び出さずに init 内で raise すると `TypeError` になる

"関数オブジェクトは `module` 属性を持たない

`*args` はキーワード引数の後に続くことはできない

コンテキストマネージャーの exit() は完了まで実行されないジェネレータでは呼び出されない

パッケージの path 属性は、MicroPython では異なるデータ型を持つ(文字列のリストではなく、単一の文字列)