AIが作ったコードが動かないとき、最初に確かめる4つの順番

「AIに作ってもらったコード、そのまま動かしたらエラーで止まった…」

ChatGPTなどのAIにお願いすると、それらしいコードはすぐにできあがります。ところが、いざ自分のパソコンで動かすと赤い文字がずらっと出て、どこが悪いのか分からない。そんなときに「もう一回作り直して」とAIに頼み続けると、別の所が壊れて、かえって遠回りになることもあります。

コードが動かない原因は、実はコードそのものより「動かす環境」や「渡したデータ」にあることがよくあります。今日は、確かめる順番を4つにまとめてご紹介します。

1. エラーの「最後の行」を読む

Pythonのエラーは長く見えますが、まず読むのは一番下の行です。そこに「何が起きたか」が短く書かれています。

たとえば、よくある例として

・ModuleNotFoundError … 使う部品（ライブラリ）が入っていない

・FileNotFoundError … 読み込むファイルが見つからない

・KeyError … 指定した列の名前や項目が見つからない

エラーの名前が分かるだけで、次に見る場所がしぼれます。英語でも、エラーの名前だけ拾えば十分です。

2. 部品・バージョン・「書きかえる所」を確かめる

AIのコードは「この部品が入っている前提」で書かれていることが多いです。ModuleNotFoundError が出たら、その部品を入れる（pip install 部品の名前）ところから始めます。

また、Python自体のバージョンや部品のバージョンがちがうと、AIが覚えている書き方が使えないことがあります。「python3 --version」でバージョンを確かめて、AIに聞くときにも一緒に伝えると、合った書き方を出してもらいやすくなります。

もうひとつ、AIのコードには、あなたの環境に合わせて書きかえる前提の所がよく入っています。

・ファイルの置き場所（パス）やファイル名

・シート名や列の名前

・「YOUR_API_KEY」のような仮の文字

特にファイル名や列の名前は、1文字ちがうだけで動きません。コードの中の「仮の値」を探して、自分の環境の名前と見比べてみてください。

3. 渡したデータの形を見る

コードが正しくても、読み込むデータが想定とちがうと止まります。

・見出しの行がない、または2行ある

・途中に空の行や、合計の行が混ざっている

・数字のはずの所に「―」や「未定」が入っている

AIは、あなたの本物のデータを見ずにコードを書いています。動かないときは、データの側も疑ってみるのが近道です。小さなテスト用のデータで動くかを先に試すと、原因の切り分けがしやすくなります。

4. AIに聞き直すときは「全文」と「やったこと」を渡す

ここまで見ても分からないときは、AIに聞き直します。そのとき「動きません」だけでなく、次の3つを一緒に渡すと、的外れな作り直しが減ります。

・エラーの全文（最後の行だけでなく、全部）

・実行したコマンドと、Pythonのバージョン

・ここまでに試したこと

それでも直らない、そもそもどこを見ればいいか分からない、という場合は、エラーの原因を調べて直すところからお手伝いしています。原因と直し方の説明書も、オプションでお付けできます。

まとめ：作り直す前に、順番に確かめる

・エラーの最後の行を読む

・部品・バージョン・書きかえる所を確かめる

・渡したデータの形を見る

・聞き直すときは全文とやったことを渡す

この順番で見ていくと、多くの場合は途中で原因が見えてきます。まずは次にエラーが出たとき、一番下の行を読むところから試してみてください。

動くようになったコードを、毎月の集計などに組み込んで使いたいときは、Excelまわりの自動化もご相談いただけます。