0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【Python入門】付録A よくあるエラーと対処法

0
Last updated at Posted at 2026-11-13

この付録では、この教材で出会いやすいエラーと、その直し方をまとめます。エラーが出たら、まずトレースバックのいちばん下の行で、エラーの種類を確かめてください。そのうえで、下の表から同じ種類のエラーを探します。

A.1 エラーの読み方

Python のエラーには、大きく分けて2つがあります。

種類 いつ見つかるか 例
書き方の間違い プログラムを実行し始める前。1行も実行されずに止まる SyntaxError・IndentationError
実行中のエラー(例外) その行を実行したとき。それより前の行は実行されている NameError・TypeError・ValueError など

どちらも、表示を次の順に読みます(第3章(PyCharm)・第3章(VS Code)・第11章 11.2)。

  1. いちばん下の行:エラーの種類と理由(例:NameError: name 'prnt' is not defined.)
  2. そのすぐ上の File "…", line …:エラーが起きたファイルと行の番号
  3. ^ や ~ の印:その行の、間違いのある所
  4. さらに上の File "…", line …:そこまでの呼び出し元

PyCharm・VS Code は、実行する前から、間違いの多くをエディターの波線で知らせます。波線にマウスを合わせると、理由が表示されます。

A.2 書き方の間違い(SyntaxError・IndentationError)

表示されるエラー 原因と対処 章
SyntaxError: invalid character '(' (U+FF08) 記号を全角で入力している。半角で入力し直す 第3章(PyCharm・VS Code)
SyntaxError: unterminated string literal 文字列を囲む " が片方しかない。" を対にする 第3章(PyCharm・VS Code)
SyntaxError: '(' was never closed ( )・[ ]・{ } の閉じ忘れ。開きと閉じの数をそろえる 第7章
SyntaxError: expected ':' if・for・while・def・class などの行の最後の : を付け忘れている 第5章
SyntaxError: invalid syntax. Maybe you meant '==' or ':=' instead of '='? 等しいかを比べるのに = を使っている。== にする 第5章
SyntaxError: invalid syntax Python の文法に合わない書き方がある。^ の印の所と、その前の行を確かめる ―
SyntaxError: 'break' outside loop break が for・while のブロックの外にある。インデントを確かめる 第6章
SyntaxError: expected 'except' or 'finally' block try: の後に except か finally が無い 第11章
IndentationError: unexpected indent インデントが要らない行の先頭に、空白が入っている 第3章(PyCharm・VS Code)
IndentationError: expected an indented block after … : で終わる行の次の行を、インデントしていない 第5章
IndentationError: unindent does not match any outer indentation level 同じブロックの行で、インデントの深さがそろっていない 第5章

【便利な使い方】閉じ忘れのエラーは、開いた所を指す

(・[・{ を閉じ忘れると、「SyntaxError: '(' was never closed」のように表示され、行の番号と ^ の印は、閉じていない ( を開いた所を指します。その ( に対応する ) がどこにあるべきかを確かめてください。表示された行が正しく見えるときは、その前の行も確かめます。

A.3 実行中のエラー(例外)

表示されるエラー 原因と対処 章
NameError: name '…' is not defined 定義されていない名前を使っている。打ち間違い(大文字と小文字の違いも)、変数に値を入れる前に使っている、関数の中の変数を外で使っている、のどれか。Did you mean: … が表示されたら、それが正しい名前の手がかり 第4章・第8章
TypeError: can only concatenate str (not "int") to str 文字列と数を + でつなげている。f-string を使う 第4章
TypeError: … missing 1 required positional argument: '…' 関数を呼び出すときの引数が足りない 第8章
TypeError: … takes 0 positional arguments but 1 was given メソッドの最初の引数に self を書き忘れている(関数のときは、引数を多く渡している) 第10章
TypeError: Employee() takes no arguments __init__ の名前を打ち間違えている(__int__ など)。init の前後に _ を2つずつ付ける 第10章
TypeError: 'tuple' object does not support item assignment タプルの中身を変えようとしている。リストを使う 第7章
ValueError: invalid literal for int() with base 10: '…' int( ) に、数字でない文字列を渡している。入力された値なら try・except ValueError で受け止める 第4章・第11章
ZeroDivisionError: division by zero 0 で割っている。割る数(空のリストの len など)を確かめる 第11章
IndexError: list index out of range リストに無いインデックスを指定している。インデックスは 0 から「要素の数 − 1」まで 第7章
KeyError: '…' 辞書に無いキーを指定している。キーの打ち間違いを確かめるか、get( ) を使う 第7章
ValueError: list.remove(x): x not in list リストに無い値を remove で取り除こうとしている。in で、含まれるかを確かめてから取り除く 第7章
AttributeError: '…' object has no attribute '…' 属性やメソッドの名前を打ち間違えている。'NoneType' object … と表示されるときは、変数に None が入っている(関数が None を返した など) 第10章

A.4 ライブラリ・ファイル・文字コードのエラー

表示されるエラー 原因と対処 章
ModuleNotFoundError: No module named 'openpyxl' openpyxl が、プログラムを動かしている仮想環境(.venv)に入っていない。PyCharm は「Python パッケージ」の画面で入れる。VS Code はターミナルで pip --version を実行して .venv の pip であることを確かめてから、pip install openpyxl を実行する 第9章
ModuleNotFoundError: No module named '…'(自分のファイル) import したファイルが、実行したファイルと同じフォルダーに無いか、名前を打ち間違えている 第9章
ImportError: cannot import name 'Employee' from 'employee' ファイルは読み込めたが、その中にあるはずのクラスや関数が無い。名前の打ち間違い(大文字と小文字の違いも)を確かめる 第13章
AttributeError: module 'random' has no attribute 'choice' (consider renaming …) など 標準ライブラリと同じ名前のファイル(random.py・types.py・csv.py など)を作っている。自分のファイルの名前を変える 第9章
FileNotFoundError: [Errno 2] No such file or directory: '…' 開こうとしたファイルが無い。名前の打ち間違いと、ファイルが python-practice の中にあるかを確かめる 第12章
PermissionError: [Errno 13] Permission denied: '…' 書き込もうとしたファイルを、Excel などで開いたまま。閉じてから実行し直す 第9章・第12章
UnicodeDecodeError: 'cp932' codec can't decode … open に encoding="utf-8" を付け忘れている 第12章
Excel で CSV ファイルを開くと、日本語が文字化けする CSV ファイルを encoding="utf-8-sig" で書く 第12章

A.5 ツールの操作でのつまずき

症状 PyCharm の場合 VS Code の場合
プログラムが止まらない(無限ループ) 「実行」の欄の停止のボタン、または Ctrl + F2 「ターミナル」の欄をクリックしてから Ctrl + C
直したのに、前と同じ結果になる 自動で保存されるので、通常は起きない。実行したファイルが、直したファイルと同じかを確かめる(右上の実行の設定の名前) 保存していない。タブの ● が消えるまで Ctrl + S で保存する
入力した文字がコードに入ってしまった Ctrl + Z で元に戻し、「実行」の欄(VS Code は「ターミナル」の欄)をクリックしてから入力する([第4章 4.6](https://qiita.com/chida0818/items/1b2dd2a4c52f769f9fe7#46-キーボードから入力する))
プログラムの Python が 3.14 ではない 設定の Python → すべてのインタープリター で、.venv の Python 3.14 が選ばれているかを確かめる。画面の右下の .venv [3.14.10] の表示でも確かめられる 画面の右下の Python の版の表示をクリックし、.venv の Python 3.14 を選ぶ
ターミナルに「…Activate.ps1 を読み込むことができません」と表示される ― PowerShell でスクリプトを実行できない設定になっている。[第9章 9.4.2](https://qiita.com/chida0818/items/efa217b10b55ccb8e4b4#仮想環境が有効にならないとき) の手順で設定を変える
ファイルを .venv の中に作ってしまった ファイルを python-practice のすぐ下にドラッグして移す(または作り直す)。.venv の中のほかのファイルは消さない

前へ

第13章 社員管理のプログラムを作る

次へ

付録B 文法早見表・操作の対応表・用語集

目次へ

【Python入門】目次

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?