この付録では、この教材で出会いやすいエラーと、その直し方をまとめます。エラーが出たら、まずトレースバックのいちばん下の行で、エラーの種類を確かめてください。そのうえで、下の表から同じ種類のエラーを探します。
A.1 エラーの読み方
Python のエラーには、大きく分けて2つがあります。
| 種類 | いつ見つかるか | 例 |
|---|---|---|
| 書き方の間違い | プログラムを実行し始める前。1行も実行されずに止まる |
SyntaxError・IndentationError
|
| 実行中のエラー(例外) | その行を実行したとき。それより前の行は実行されている |
NameError・TypeError・ValueError など |
どちらも、表示を次の順に読みます(第3章(PyCharm)・第3章(VS Code)・第11章 11.2)。
-
いちばん下の行:エラーの種類と理由(例:
NameError: name 'prnt' is not defined.) -
そのすぐ上の
File "…", line …:エラーが起きたファイルと行の番号 -
^や~の印:その行の、間違いのある所 -
さらに上の
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 の中のほかのファイルは消さない |
|