新人エンジニア研修に効くデバッグクエストの作り方:Python・API・JSON

新人開発者が最初につまずくのは、難しいアルゴリズムよりも実務コードのエラーを読み解くことです。IndexError や NameError、API のステータスコード、ネストした JSON を題材に、実務の思考力を育てるデバッグ型クエストの例を紹介します。

First Run チーム
•約3分
この記事の目次

新人開発者が入社して最初に苦労するのは、見慣れないアルゴリズム問題よりも、実務のコードに潜む基本的なエラーログを正しく読み、対処することです。オンボーディングでは、実務ですぐに役立つデバッグ中心のクエストを用意することが大切です。

IndexErrorとゼロ始まり

意外に多いのが、リストの範囲を超えて要素を参照してしまうミスです。インデックスが 0 から始まるというルールを見落とすと、範囲外へのアクセスが起きます。クエストでは、リストの長さと参照する位置を確かめる習慣と、例外を適切に扱う方法を身につけます。

NameErrorとタイプミス

宣言していない変数を参照したり、変数名のつづりを間違えたりして起きる NameError は、単純なわりに原因探しで思いのほか時間を取られます。大文字と小文字の違いや、camelCase と snake_case の混在にも注意が必要です。エディタのリント設定や命名規則を確認する感覚を、短い問題で身につけます。

ステータスコードとJSON

Web 開発では、クライアントとバックエンドの通信が欠かせません。400 Bad Request と 500 Internal Server Error の違いのように、ステータスコードからエラーの原因がどちら側にあるかを素早く見分け、ネストした JSON のキー構造に正しくアクセスしてデータを取り出す練習をします。

IndexErrorのコード例

架空のクエスト例です。インデックスの範囲を確かめる練習として、次のようなコードを使います。

python
# IndexError の例外処理を練習するコードクエストの例
try:
    items = ["scope", "risk", "quality"]
    # 4番目の値を取得しようとして例外が発生する
    selected = items[3]
except IndexError as e:
    print("インデックスが範囲外です。先にリストの長さを確認してください。")

items の要素は3つなので、使えるインデックスは 0 から 2 までです。First Run の開発者クエストでも、数行のコードを読んで出力を予測したり、エラーの原因を探したりする形式を使っています。長いコードを読ませるより、判断の分かれ目が1か所だけある短いコードのほうが、何を学んだのかがはっきり残ります。

開発者研修のチェック

  • 構文の暗記ではなく、実務コードのデバッグが中心の問題になっているか
  • よくある範囲外参照、タイプミス、型のエラーが含まれているか
  • API 通信とデータのパースを正しく扱っているか

実務シナリオをクエストで体験してみませんか

開発、PMO、マークアップ、企画、デザインの職種別オンボーディングクエストは、First Run のデモで実際にプレイできます。

オンボーディングRPGを今すぐプレイ

First Runの仮想オフィスを歩きながら、開発・企画・デザイン・PMO・マークアップの実務シナリオをJRPG風のクエストで体験してみましょう。

関連記事