‘int’ object is not iterableの原因と直し方｜再現20例

この記事で実際に動かしたもの：エラーを出すコード44本と直したコードを Python 3.13 で実行し、NumPy・pandas を使わない35本を 3.14・3.12・3.11 でも動かして文言を比べ、IPython 9.18.1 で表示を確かめ、mypy 2.4.1 で実行前に見つかるかを確かめました。

flowchart TD
    E[not iterable] --> T[type と値を表示]
    T --> N{型は?}
    N -->|int| R[range]
    N -->|None| F[return]
    N -->|関数| P[かっこ]

やりたいことごとに、いちばん早い方法を先にまとめます。

確認環境：Ubuntu 24.04.5 LTS の上で、Python 3.13.18 を主に使い、エラーを出すコード（for文に整数・len() の結果・sum／max／list／set／sorted／enumerate／zip／map への整数・extend と +=・アンパック・辞書のループ・戻り値が None・list.sort() の戻り値・整数の桁・JSON の数値・NumPy と pandas の集計結果・再帰・メソッドのかっこ忘れ・自作クラス・yield from・* での展開など）を1本ずつ実行してトレースバックの原文を取り、直したコードの出力も同じ環境で取りました。同じコードを Python 3.14.6（作業用の場所に uv で導入）・3.12.3・3.11.18 でも実行して文言を比べ、Jupyter と同じ表示は IPython 9.18.1、実行前の検出は mypy 2.4.1（どちらも作業用の仮想環境に導入）で確かめました。判定方法の速さは timeit で100万回×5回を測った最小値です。iterable と iterator の定義は Python 公式ドキュメント（用語集・組み込み関数 iter・collections.abc）で確かめました。Windows・Mac では実行していませんが、このエラーの文言と原因は OS に依存しない Python 本体の動作です。図は mermaid で描画を確かめています（確認日 2026年11月5日）。

TypeError: 'int' object is not iterableの意味（エラー文の読み方）

この節では、エラー文の日本語訳と、「iterable（イテラブル）」が何を指すかが分かります。

「TypeError: 'int' object is not iterable」を日本語にすると「型のエラー：int（整数）のオブジェクトは反復可能ではありません」です。 「反復可能（iterable）」は「中身を1個ずつ順に取り出せる」という意味です。Python 公式ドキュメントの用語集は iterable を次のように説明しています。

An object capable of returning its members one at a time.（要素を1つずつ返すことのできるオブジェクト）

リスト・タプル・文字列・辞書・集合・range は中身を1個ずつ取り出せますが、14 のような整数には「中身」がありません。手元で、整数を for文に渡すと次のように止まりました。

count = 14
for i in count:
    print(i)

Traceback (most recent call last):
  File "/srv/s4/r17/t295/s/c01_for_int.py", line 2, in <module>
    for i in count:
             ^^^^^
TypeError: 'int' object is not iterable

エラー文の3つの部品

引用符の中の型名が変わるだけで、同じ仕組みのエラーがいくつもあります。 手元では 'NoneType' object is not iterable（値が None）、'float' object is not iterable（小数）、'bool' object is not iterable（True・False）、'numpy.int64' object is not iterable（NumPy の数）、'function' object is not iterable（関数そのもの）が出ました。どれも「そこに入っている値は、思っている型ではない」という知らせです。

not iterableの原因一覧（20種）と自分の場合の見分け方

この節では、このエラーになる原因の全体像と、エラーの行から原因を絞り込む手順が分かります。

原因は「回数のつもりの数を回した」「データの集まりのつもりが数（や None）だった」の2系統に分かれます。 手元で再現した20種を、その2系統と出る文言で並べました。

自分の場合を3つの手順で絞り込む

原因1〜3：for文に数やlen()を渡した（rangeの書き忘れ）

この節では、for文で 'int' object is not iterable が出るいちばん多い形と、range を使わない書き方が分かります。

原因1：for i in 整数

前の節の for i in count: の形です。range() で包むと 0 から count−1 までを1個ずつ返すので、手元では 3 回くり返す例が 0 1 2 を出しました。

count = 3
for i in range(count):
    print(i, end=" ")   # 0 1 2

ユーザーの入力から回数を受け取る場合も同じで、for i in range(int(input())) と書きます。input() の結果は文字列なので、int() を付けずに for i in input() と書くとエラーにはならず、入力した文字を1文字ずつ回す別のバグになります。

原因2：for i in len(a)

検索上位の記事でも取り上げられている、数を数える関数の例です。len() は「個数」という1個の整数を返すので、そのままでは回せません。

def count_occurrence(values, to_find):
    n = 0
    for i in len(values):
        if values[i] == to_find:
            n += 1
    return n

print(count_occurrence([1, 2, 3, 3], 3))

Traceback (most recent call last):
  File "/srv/s4/r17/t295/s/c02_len.py", line 8, in <module>
    print(count_occurrence([1, 2, 3, 3], 3))
          ~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^
  File "/srv/s4/r17/t295/s/c02_len.py", line 3, in count_occurrence
    for i in len(values):
             ~~~^^^^^^^^
TypeError: 'int' object is not iterable

トレースバックは下から読みます。一番下の File の行（3行目の for i in len(values):）がエラーの起きた場所で、その上は呼び出し元です。直し方は3通りあり、手元ではどれも 2 を返しました。

# 1. range で包む（番号が要るとき）
for i in range(len(values)):
    if values[i] == to_find: ...

# 2. 要素で回す（番号が要らないとき。こちらが短い）
n = sum(1 for v in values if v == to_find)

# 3. 用意されたメソッドを使う
n = values.count(to_find)

番号を自分で計算する range(len(a)) は、範囲を1つ間違えると別のエラー（IndexError）につながります。 番号も要るなら for i, v in enumerate(values): と書くと、範囲を計算せずに済みます。for文と range の書き方は関連記事「Python for文とrangeの使い方｜1始まり・逆順・enumerate早見表」で扱っています。番号がずれたときの IndexError は、第49弾の「list index out of rangeの原因と直し方｜Python再現10例」で扱う予定です。

原因3：range() に小数を渡した

range を付けても、中身が小数なら別の文言で止まります。平均や割り算の結果（/ は必ず小数を返す）を回数に使うと起きます。

    for i in range(2.5):
             ~~~~~^^^^^
TypeError: 'float' object cannot be interpreted as an integer

回数は整数にしてから渡します。切り捨てなら int(x) か、割り算を //（切り捨ての割り算）にします。小数そのものを for に渡した場合は 'float' object is not iterable、True・False を渡した場合は 'bool' object is not iterable になりました。

原因4〜8：sum・max・listなどの関数に数を渡した

この節では、for文を書いていないのに 'int' object is not iterable が出る理由と、関数ごとの直し方が分かります。

sum・max・min・list・set・tuple・dict・sorted・enumerate・zip・map・extend は、どれも中で for文と同じ「1個ずつ取り出す」処理をしています。 そのため、引数に整数を渡すと同じ文言で止まります。手元で1つずつ出した原文です。

関数の中で出ると、呼び出し元が原因

自分で書いた関数の中で sum を使っていると、エラーの行は関数の中を指しますが、原因は呼び出し元の引数です。

def total(values):
    return sum(values)

print(total(5))

Traceback (most recent call last):
  File "/srv/s4/r17/t295/s/c03_sum.py", line 4, in <module>
    print(total(5))
          ~~~~~^^^
  File "/srv/s4/r17/t295/s/c03_sum.py", line 2, in total
    return sum(values)
TypeError: 'int' object is not iterable

一番下の行（return sum(values)）だけを見ると sum が悪いように見えますが、1つ上の行の total(5) が整数を渡しています。 手元では、この return sum(values) の行には ^ の印が付きませんでした。印は「行の一部」が原因のときに付き、行全体が1つの式のときは省かれます。1個だけの値を渡すなら total([5]) とリストで包みます。

append と extend の取り違え

append は「1個を末尾に足す」、extend と += は「集まりの中身を全部足す」です。1個の整数を足すなら append を使います。手元では items = [1, 2] に items.append(3)、続けて items += [4] として [1, 2, 3, 4] になりました。items += 3 の行は、3.13 でも ^ の印が付かない形で表示されました。

random.choices は別の文言になる

検索上位の記事では random.choices の引数の取り違えも原因に挙がっていますが、手元の Python 3.13 では random.choices(3, ["red", "blue"]) が TypeError: object of type 'int' has no len() になり、not iterable とは別の文言でした。choices は最初に len(population) を呼ぶためです。正しくは random.choices(["red", "blue"], k=3) で、手元では（乱数の種0で）['blue', 'blue', 'red'] が返りました。

原因9〜11：アンパックで出る cannot unpack non-iterable int object

この節では、a, b = ... の形で出る文言の違いと、辞書のループ・関数の戻り値での直し方が分かります。

「cannot unpack non-iterable int object」は「取り出せない整数を、複数の変数に分けようとした」という意味です。 文言は for文のときと違いますが、仕組みは同じです。

    a, b = 10
    ^^^^
TypeError: cannot unpack non-iterable int object

原因10：辞書を for k, v in d で回した

辞書をそのまま for で回すと、取り出されるのはキーだけです。キーが整数だと、1個の整数を k と v に分けようとして止まります。

scores = {1: 80, 2: 45}
for k, v in scores:
    print(k, v)

Traceback (most recent call last):
  File "/srv/s4/r17/t295/s/c11_dict.py", line 2, in <module>
    for k, v in scores:
        ^^^^
TypeError: cannot unpack non-iterable int object

キーと値の組を取り出すのは scores.items() です。手元では 1 80 | 2 45 | と出ました。キーが文字列の辞書で同じ書き方をすると、文字列が1文字ずつ分けられます。手元では {"ab": 1, "cde": 2} で、2文字のキー "ab" は a b とエラー無しに分かれてしまい、3文字の "cde" で ValueError: too many values to unpack (expected 2) になりました。エラーにならない分だけ気づきにくいので、辞書を2つの変数で回すときは .items() と覚えておきます。

原因11：1個しか返さない関数を2つに分けた

def minmax(a):
    return min(a)           # 1個しか返していない

lo, hi = minmax([3, 1, 2])  # TypeError: cannot unpack non-iterable int object

return min(a), max(a) と書くと、カンマで区切った値はタプルとして返り、2つの変数に分けられます。手元では lo, hi が 1 3 になりました。リストの中の要素を回すときに出る場合（for a, b in [get_pair(), get_pair()] で get_pair が整数を返す）も、同じ文言でした。

原因12〜14：関数の戻り値がNone（'NoneType' object is not iterable）

この節では、None で同じエラーが出る3つの典型と、None を返す関数の扱い方が分かります。

Python の関数は、return を書かないと None を返します。 その戻り値を for で回すと 'NoneType' object is not iterable になります。整数の場合よりも原因が離れた場所にあるので、気づきにくい形です。

原因12：return の書き忘れ

def load_users():
    users = ["tanaka", "suzuki"]
    print(len(users), "users")

for u in load_users():
    print(u)

2 users
Traceback (most recent call last):
  File "/srv/s4/r17/t295/s/c05_none.py", line 5, in <module>
    for u in load_users():
             ~~~~~~~~~~^^
TypeError: 'NoneType' object is not iterable

「2 users」は表示されたので関数は動いていますが、結果を返していません。最後に return users を足すと、手元では tanaka suzuki と出ました。

原因13：nums = nums.sort()

list.sort() はリストをその場で並べ替え、None を返します。手元で print(nums.sort()) は None を表示しました。戻り値を代入すると、リストが None に置き換わります。

    for n in nums:
             ^^^^
TypeError: 'NoneType' object is not iterable

原因14：見つからないときだけ None を返す関数

見つかったときだけ return key, value を書いた関数は、見つからないと最後まで進んで None を返します。

    k, v = find({"a": 1}, "b")
    ^^^^
TypeError: cannot unpack non-iterable NoneType object

見つからないことがありうるなら、受け取る側で None を先に判定します。

def find(d, key):
    if key in d:
        return key, d[key]
    return None              # 見つからないときを明示する

r = find({"a": 1}, "b")
if r is not None:
    k, v = r
else:
    print("not found")       # 手元の出力：not found

None の判定を if r: ではなく is not None で書く理由は、関連記事「Python None判定はis Noneで｜空文字・空リスト・0との違い早見表」で扱っています。None に [0] を付けたときのエラーは関連記事「NoneType object is not subscriptableの直し方」、None のメソッドを呼んだときのエラーは関連記事「'NoneType' object has no attributeの直し方」で扱っています。3つとも「None が入っている」という同じ根を持つので、出た場所ではなく None を作った場所を探します。

原因15〜18：整数の桁・JSONの数値・NumPyとpandasの集計結果

この節では、データの読み込みや集計のあとで出る 'int' object is not iterable と、型が想定とずれる場所が分かります。

原因15：整数の各桁を回した

「2026 の各桁の和」のように桁を1つずつ扱いたいとき、整数のままでは回せません。

    for d in n:
             ^
TypeError: 'int' object is not iterable

文字列にすると1文字ずつ取り出せます。手元では次の2通りがどちらも 10 を返しました。

n = 2026
print(sum(int(d) for d in str(n)))   # 10
print(sum(map(int, str(n))))         # 10

原因16：JSON の「件数」の項目を回した

API の応答では、件数（整数）と一覧（リスト）が並んで返ることがよくあります。

import json
payload = json.loads('{"count": 2, "items": ["a", "b"]}')
for x in payload["count"]:     # TypeError: 'int' object is not iterable
    print(x)

手元で type(payload["count"]).__name__ は int でした。くり返すなら range(payload["count"])、中身を回すなら payload["items"] と、項目の役割で使い分けます。手元では 0 1 a b と出ました。API によっては、1件のときはリストでなく1個の値、0件のときは null（None）を返すものもあるので、受け取った直後に型を確かめておくと原因の場所が近くなります。

原因17：NumPy・pandas の集計結果を回した

NumPy・pandas の sum()・mean() は1個の数を返します。型名が Python の int ではなく numpy.int64 になるので、文言が少し変わります。

    for x in df["age"].sum():
             ~~~~~~~~~~~~~^^
TypeError: 'numpy.int64' object is not iterable

0次元の配列（np.array(5)）を回した場合は、さらに別の文言 TypeError: iteration over a 0-d array でした。手元の NumPy 2.5.3・pandas 3.0.5 での出力と直し方です。

原因18：再帰関数が整数を返した

入れ子のリストを平らにする関数で、「整数ならそのまま返す」と書くと、呼び出し元の extend が整数を受け取ります。

  File "/srv/s4/r17/t295/s/c25_rec.py", line 6, in flatten
    out.extend(flatten(e))
    ~~~~~~~~~~^^^^^^^^^^^^
TypeError: 'int' object is not iterable

関数の戻り値の型を、どの分岐でもそろえるのが直し方です。return x を return [x] にすると、手元では flatten([1, [2, 3]]) が [1, 2, 3] を返しました。「ある分岐では整数、別の分岐ではリスト」という関数は、原因14の None と同じく、呼んだ側で突然止まります。

原因19・20：かっこの付け忘れと、自作クラスの not iterable

この節では、'function'・'method'・自作クラスの名前で出る not iterable と、自分のクラスを for で回せるようにする方法が分かります。

原因19：メソッド・関数の () 忘れ

かっこを付けないと、関数は呼ばれず「関数そのもの」が渡されます。手元で出た原文です。

'type' object is not iterable は、list・dict という型の名前そのものを回したときの文言です。変数名に list を使うつもりで書き間違えたときなどに出ます。正規表現の結果は、手元では re.search(r"(\w+)=(\d+)", "id=42").groups() が ('id', '42')、re.findall(r"\d+", "a1 b22") が ['1', '22'] を返しました。

原因20：__iter__ の無い自作クラス

自分で作ったクラスは、何もしなければ for で回せません。エラーにはクラス名が出ます。

    for x in Cart():
             ~~~~^^
TypeError: 'Cart' object is not iterable

__iter__ メソッドで、中のリストのイテレーター（次の節で説明）を返すと回せるようになります。in での判定も同時に使えるようになりました。

class Cart:
    def __init__(self):
        self.items = ["apple", "milk"]

    def __iter__(self):
        return iter(self.items)

print(list(Cart()), "milk" in Cart())   # ['apple', 'milk'] True

__iter__ をジェネレーター（yield を使う関数）で書く方法もあります。ジェネレーターの書き方は関連記事「Pythonジェネレータとyield｜使い所とメモリ比較コード集」で扱っています。

iterableとiteratorの違い（iter・next・ジェネレーター）

この節では、エラー文に出る iterable と、よく似た iterator の違いと、「エラーは出ないのに2回目が空になる」落とし穴が分かります。

iterable は「1個ずつ取り出せるもの」、iterator は「取り出している途中の位置を覚えている係」です。 for文は、iterable を iter() に渡して iterator を受け取り、next() で1個ずつ取り出し、終わりの合図（StopIteration）で止まります。公式ドキュメントの用語集も「for 文はこれを自動で行う」と説明しています。

nums = [1, 2, 3]
it = iter(nums)
print(type(it).__name__)          # list_iterator
print(next(it), next(it), next(it))  # 1 2 3
next(it)                          # StopIteration

手元で next([1, 2, 3]) を実行すると TypeError: 'list' object is not an iterator でした。文言の最後が「iterable」か「an iterator」かで、意味が違います。 not iterable は「そもそも回せない」、not an iterator は「回せるが next() は直接呼べない」で、後者は next(iter(nums)) と書けば動きます。

2回目が空になる落とし穴

ジェネレーター式は iterator なので、1回使い切ると空になります。エラーは出ません。

g = (x * 2 for x in [1, 2, 3])
print(list(g), list(g))   # [2, 4, 6] []

2回使うなら、list() でリストにして保存するか、クラスに __iter__ を書いて毎回新しい iterator を作ります。手元では、前の節の Cart と同じ作りのクラスで list(c), list(c) が2回とも同じ中身を返しました。

iterableかどうかを確かめる方法（iter・isinstance・mypy）

この節では、値が回せるかをプログラムで判定する3つの方法の違いと、実行する前に型チェッカーで見つける方法が分かります。

手元で、よく使う型を3つの方法で判定した結果です。

3行目が判定方法の差です。 Python 公式ドキュメント（collections.abc）は、isinstance(obj, Iterable) は __getitem__ で回すクラスを検出しないとし、「iterable かどうかを確実に判定する唯一の方法は iter(obj) を呼ぶこと」と書いています。手元でも、__getitem__ だけのクラスは isinstance が False なのに list() で [0, 10, 20] を返しました。

def is_iterable(x):
    try:
        iter(x)
        return True
    except TypeError:
        return False

100万回ずつ呼んだ1回あたりの時間です（5回測った最小値）。

差は1回あたり数百ナノ秒で、速さより判定の正しさで選びます。外から来た値を受け取る関数の入口なら try iter()、型ヒントと合わせて読みやすく書くなら isinstance が向きます。

「1個でもリストでも受け取る」関数の落とし穴

「回せなければリストで包む」関数を書くと、文字列が1文字ずつに分かれます。文字列は iterable だからです。

from collections.abc import Iterable

def to_list(x):
    if isinstance(x, (str, bytes)) or not isinstance(x, Iterable):
        return [x]
    return list(x)

文字列を除かない版では、手元で "abc" が ['a', 'b', 'c'] になりました。上の版では 5 → [5]、"abc" → ['abc']、[1, 2] → [1, 2] です。ただし、どんな値でも受け取る関数は原因を隠しやすく、呼び出し元の誤りに気づく機会が減ります。まず呼び出し元で正しい型を渡せないかを考えます。

実行前に mypy で見つける

型ヒントを書いて型チェッカーの mypy を通すと、実行する前に見つかります。手元の mypy 2.4.1 で、原因2・12・9 を1つのファイルにまとめて調べた出力です。

def count_occurrence(values: list[int], to_find: int) -> int:
    n = 0
    for i in len(values):
        if values[i] == to_find:
            n += 1
    return n

def load_users() -> None:
    users = ["tanaka", "suzuki"]
    print(len(users), "users")

for u in load_users():
    print(u)

a, b = 10

typed.py:3: error: "int" has no attribute "__iter__"; maybe "__int__"? (not iterable)  [attr-defined]
typed.py:12: error: "load_users" does not return a value (it only ever returns None)  [func-returns-value]
typed.py:12: error: "None" has no attribute "__iter__" (not iterable)  [attr-defined]
typed.py:15: error: "int" object is not iterable  [misc]
Found 4 errors in 1 file (checked 1 source file)

型ヒントの無い関数は調べられませんでした。 原因12のコードを型ヒント無しで mypy に通すと Success: no issues found で、--check-untyped-defs を付けても同じでした。戻り値の型（-> None や -> list[str]）を書いて初めて、呼び出し側の誤りが見つかります。型ヒントの書き方は関連記事「Pythonの型ヒントの書き方｜3.12以降の新しい書き方まで」で扱っています。

似たエラーとの違いと環境別の見え方（3.11〜3.14・Jupyter）

この節では、not iterable に似た文言の見分け方、Python 3.14 で変わった文言、環境ごとの表示の違いが分かります。

文言の前半で、どの操作で起きたかが分かります。 手元で1つずつ出した原文です。

最後の join は、リスト自体は回せるが中の要素が文字列でないという別の問題です。",".join(map(str, [1, 2])) と書きます。

Python 3.14 で in 演算子の文言が変わった

NumPy・pandas を使わない35本を Python 3.13.18 と 3.14.6 で実行して最後の行を比べると、違ったのは in 演算子の2本だけでした。

3.13: TypeError: argument of type 'int' is not iterable
3.14: TypeError: argument of type 'int' is not a container or iterable

3.13: TypeError: argument of type 'NoneType' is not iterable
3.14: TypeError: argument of type 'NoneType' is not a container or iterable

3.14 では「container（in で中を調べられるもの）でも iterable でもない」と、in が使える条件を両方挙げる文言になっています。手元で確かめた範囲では、Python 3.14 の「What's New」の改善されたエラーメッセージの項に、この変更は載っていませんでした。エラー文で検索するときは、3.14 なら「not a container or iterable」、3.13 以前なら「is not iterable」 で探すと、同じ原因の情報に当たります。直し方は同じで、stock = {"apple": 5} のように辞書やリストにしてから in を使うと、手元では True が返りました。

環境別の見え方（Python 3.10以前・3.11〜3.14・Jupyter）

このエラーの文言と原因は、Windows・Mac・Linux で同じです。 違うのは表示の形で、Python の版と、ターミナル・Jupyter のどちらで動かすかで変わります。版はターミナルで python3 --version（Windows の公式インストーラーで入れた場合は py --version）と打つと分かります。手元の 3.11.18・3.12.3・3.13.18・3.14.6 では、in 演算子以外の最後の行の文言は同じでした。

IPython 9.18.1 で原因1のコードを実行したときの表示です。Jupyter Notebook も同じ IPython が表示を作ります。

---------------------------------------------------------------------------
TypeError                                 Traceback (most recent call last)
Cell In[1], line 2
      1 count = 14
----> 2 for i in count:
      3     print(i)

TypeError: 'int' object is not iterable

Jupyter では、前のセルで count = len(data) のように同じ名前に整数を入れ直したまま、別のセルで for x in count を実行して止まることがあります。「さっきまで動いていた」なら、カーネルを再起動して上から順に実行し直すと、どのセルで値が変わったかが分かります。

よくあるエラー／つまずき

この節では、not iterable の周辺でつまずきやすい点を、症状・原因・直し方の表で確かめられます。

境界の値で試す

このエラーは、「普段はリストなのに、1件のときだけ数」「0件のときだけ None」のように、データの件数が境界にあるときに出がちです。関数の入口で型を確かめ、0件・1件・複数件の3通りを試すと、本番のデータを流す前に見つかります。

• 1回数として使う数に range を付けたかfor・enumerate・list に回数を渡すときは range(n)
• 2関数のすべての分岐で同じ型を返しているかreturn の書き忘れ・見つからないときの None・再帰の整数
• 3その場で変更するメソッドの戻り値を代入していないかsort・append・extend・reverse は None を返す
• 4外から来たデータの型を確かめたかJSON・API・pandas の集計は、件数と一覧・1個の数と列を区別する
• 5型ヒントを書いて mypy を通したか戻り値の型を書いた関数なら、実行前に見つかる

判断表：not iterableの直し方の選び方

この節では、場面ごとにどの直し方を選ぶかが一覧で分かります。

1. 1最後の行の型名を見るint・NoneType・float・function・numpy.int64・自作クラス名
2. 2自分のファイルの行と ^ の印を見る印の下が取り出せなかった値。関数の中なら1つ上の呼び出し元も
3. 3回数か、集まりかを決める回数なら range、集まりのはずなら値の出どころを調べる
4. 4型ヒントを書いて再発を防ぐ戻り値の型を書くと、mypy が呼び出し側の誤りを指摘する

大事なのは、エラーを消すことより「なぜそこに整数（や None）が入ったのか」を説明できるようにすることです。回数なら range を付け、集まりのはずなら値を作った場所を直します。

よくある質問

この節では、'int' object is not iterable について検索されることの多い疑問に答えます。

Q. 'int' object is not iterable の日本語の意味は？

A. 「int（整数）のオブジェクトは反復可能ではありません」、つまり「整数は1個ずつ取り出せない」という意味です。for文や sum・list に整数を渡したときに出ます。

Q. iterable とは何ですか？

A. 要素を1個ずつ順に取り出せるもののことです。リスト・タプル・文字列・辞書・集合・range・ファイルなどが当てはまり、整数・小数・True/False・None は当てはまりません。

Q. for文で数字の回数だけくり返すには？

A. for i in range(n): と書きます。range(5) は 0〜4 を1個ずつ返します。1から始めたいときは range(1, n + 1) です。

Q. 'NoneType' object is not iterable は何が違う？

A. 回そうとした値が None だったという意味です。return を書き忘れた関数や、a = a.sort() のように None を返すメソッドの結果を回したときに出ます。

Q. cannot unpack non-iterable int object の意味は？

A. 1個の整数を a, b = ... で複数の変数に分けようとした、という意味です。辞書を .items() なしで2つの変数で回したときにもよく出ます。

Q. iterable と iterator の違いは？

A. iterable は回せるもの、iterator は回している途中の位置を覚えている係です。iterator は1回使い切ると空になり、2回目はエラーにならずに何も返しません。

Q. 値が iterable かどうかを判定するには？

A. 公式ドキュメントは iter(x) を呼んで TypeError になるかで判定する方法を、確実な唯一の方法としています。isinstance(x, Iterable) は __getitem__ だけで回せるクラスを見落とします。

Q. 整数の各桁を for で回したいときは？

A. str(n) で文字列にしてから回し、1文字ずつ int() に戻します。2026 の各桁の和は sum(map(int, str(2026))) で 10 でした。

Q. Python 3.14 でエラー文が違うのはなぜ？

A. in 演算子の文言が「argument of type 'int' is not a container or iterable」に変わっています。手元の 3.13.18 と 3.14.6 で比べると、比べた35本中この2本だけが違いました。for文などの 'int' object is not iterable は同じです。

Q. try-except で囲めば解決？

A. 外から来るデータの型が決まっていない入口では有効です。ただ、関数の戻り値の書き忘れのようなバグを隠すと、別の場所で結果がおかしくなります。まず整数や None が入った理由を直します。

まとめ

この節では、記事の要点を5つに絞って振り返ります。

• 意味：整数（など1個の値）を、1個ずつ取り出す操作（for・sum・list・アンパック・in）に渡した。
• 特定：最後の行の型名と、自分のファイルの行の ^ の印を見る。関数の中なら呼び出し元の引数を確かめる。
• 原因：「回数のつもりの数を回した」（range の書き忘れ・len()）か、「集まりのつもりが数・None だった」（戻り値・sort()・JSON・集計結果・再帰）の2系統。
• 直し方：回数なら range(n)、1個なら [x]、辞書は .items()、並べ替えは sorted()、関数はすべての分岐で同じ型を返す。
• 予防：戻り値の型ヒントを書いて mypy を通す。判定が要るなら iter(x) を try で呼ぶ。

参考・出典

この節では、この記事で確かめた公式の資料が分かります（確認日 2026年11月5日）。

• Python 公式ドキュメント「Glossary」iterable・iterator：https://docs.python.org/3/glossary.html
• Python 公式ドキュメント「Built-in Functions」iter・next・range：https://docs.python.org/3/library/functions.html
• Python 公式ドキュメント「collections.abc」Iterable：https://docs.python.org/3/library/collections.abc.html
• Python 公式ドキュメント「Built-in Exceptions」TypeError・StopIteration：https://docs.python.org/3/library/exceptions.html
• Python 公式ドキュメント「What's New In Python 3.14」：https://docs.python.org/3/whatsnew/3.14.html
• mypy 公式ドキュメント：https://mypy.readthedocs.io/
• NumPy 公式ドキュメント「numpy.atleast_1d」：https://numpy.org/doc/stable/reference/generated/numpy.atleast_1d.html

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。