シンママQAエンジニア｜初心者がVSCodeでテスト自動化を始める前に知るべき構成と設定

Python で Selenium や Appium を使ってテスト自動化を始めると、最初にぶつかるのが「フォルダ構成」と「VSCodeのデバッグ設定」です。
私も最初は import エラーやモジュールが見つからないエラーに悩まされ、コードよりも環境設定に時間を取られてしまいました。
ですが、フォルダを整理し VSCode の launch.json を設定することで、どのスクリプトも F5 一発で実行できるようになります。
この記事では、初心者がつまずきやすいポイントと、私自身の失敗から学んだフォルダ構成とデバッグ設定を紹介します。
これを押さえておけば「動かない…」と悩む時間を減らし、テストコードを書くことに集中できます。

なぜフォルダ構成が大事なのか？
おすすめのフォルダ構成
- フォルダごとの役割
VSCodeでよくあるエラーと解決法
解決方法：launch.json の設定
- この設定の効果
私が実際にハマったこと
学んだこと
これから始める方へ
まとめ

なぜフォルダ構成が大事なのか？

Python の import は「基準ディレクトリ」がずれると簡単にエラーになります。
特に Selenium や Appium のテストコードを分割して書いていくと、以下のような問題がよく起きます。

モジュールが見つからない (ModuleNotFoundError)
同じ処理を複数のスクリプトに書いてしまう
テストデータやログの場所が分からなくなる

これを避けるには、最初に「コード」「データ」「レポート」「共通モジュール」を分けておくことが重要です。

VSCodeでよくあるエラーと解決法

フォルダを整理しても、次のようなエラーに悩む人が多いと思います。

ModuleNotFoundError: No module named 'modules'

これは VSCode のデバッガが scripts/ を基準にファイルを直接実行してしまうため、ひとつ上にある modules/ を見つけられないのが原因です。

解決方法：launch.json の設定

VSCode にはデバッグ用の設定ファイル .vscode/launch.json があります。
ここに設定を追加することで、どのスクリプトでもエラーなく実行できるようになります。

設定例（方法①：現在のファイルを実行する場合）

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "test_project: 現在のファイルを実行（共通）",
      "type": "debugpy",
      "request": "launch",
      "program": "${file}",
      "cwd": "${workspaceFolder}",
      "env": { "PYTHONPATH": "${workspaceFolder}" },
      "console": "integratedTerminal",
      "justMyCode": true
    }
  ]
}