【5分で完了】Selenium×Python環境構築｜pytest＋webdriver-managerで詰まらない方法

Selenium × Pythonの環境構築を、初心者でも5分で動作確認までできるように解説します。

👉 この記事のコードをそのままコピペすれば、5分でテストが動きます。

「ChromeDriverのバージョンが合わない」「環境構築で詰まる」——そんな悩みを解決します。

本記事では、Selenium・webdriver-manager・pytestを使った実務構成で、エラーなく最短でテストを動かす方法を解説します。

👉 Playwrightとの違い：SeleniumはWebDriver経由でブラウザを操作する成熟した技法で、Playwrightより求人・案件数が圧倒的に多いです。

Seleniumの環境構築でよくある失敗は「ChromeDriverのバージョンが合わない」「パスが通っていない」の2つです。この記事ではWebDriver Managerを使ってバージョン管理を自動化するため、詰まらずに進められます。

Selenium × Python 環境構築の全体像

まず全体の流れを把握してから進めましょう。

STEP 1：Pythonのバージョン確認（Selenium環境構築の前提）

まず Python がインストールされているか確認します。

python --version
# または
python3 --version

出力例：

Python 3.11.5

STEP 2：仮想環境（venv）の作成と有効化【Python環境構築】

仮想環境を使うことでプロジェクトごとにパッケージを分離できます。実務では必ず使いましょう。

仮想環境の作成

# プロジェクトフォルダを作成
mkdir selenium-project
cd selenium-project

# 仮想環境を作成
python -m venv venv

仮想環境の有効化

有効化されると、プロンプトの先頭に (venv) と表示されます。

(venv) $ 

STEP 3：Selenium・webdriver-manager・pytestのインストール方法（Selenium Python インストール）

Selenium 4系では webdriver-manager を使うことで ChromeDriver のバージョン管理が自動化されます。手動ダウンロードは不要です。

pip install selenium webdriver-manager pytest

インストール確認：

pip list | grep -E "selenium|webdriver|pytest"

# 出力例
pytest             7.4.0
selenium           4.18.1
webdriver-manager  4.0.1

STEP 4：プロジェクト構成の作り方（pytest構成）

実務で使いやすいフォルダ構成を最初から整えておきます。

selenium-project/
├── venv/                  # 仮想環境（Gitには含めない）
├── tests/
│   ├── conftest.py        # fixture定義
│   └── test_sample.py     # テストファイル
├── requirements.txt       # 依存パッケージ一覧
└── pytest.ini            # pytest設定

pytest.ini の作成

[pytest]
testpaths = tests
addopts = -v

STEP 5：Selenium WebDriverの設定（conftest.py）

WebDriver の初期化・終了処理を conftest.py の fixture に集約するのが実務のベストプラクティスです。

# tests/conftest.py
import pytest
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager

@pytest.fixture(scope="function")
def driver():
    """Chrome WebDriverを起動・終了するfixture"""
    options = webdriver.ChromeOptions()
    # options.add_argument("--headless")  # 最初はオフ推奨（画面を見ながら確認できる）
    # CI/CD環境では上の行をオンにする
    options.add_argument("--no-sandbox")           # Linux/CI環境用（ローカルでは不要）
    options.add_argument("--disable-dev-shm-usage") # Linux/CI環境用（ローカルでは不要）
    options.add_argument("--window-size=1920,1080")

    service = Service(ChromeDriverManager().install())
    driver = webdriver.Chrome(service=service, options=options)

    yield driver  # テスト実行

    driver.quit()  # テスト終了後にブラウザを閉じる

STEP 6：動作確認テストの書き方と実行方法（pytest）

安定して動く example.com を使った動作確認テストです。GoogleはCAPTCHAやリダイレクトが発生する場合があるため、環境構築の最初の確認には example.com が最適です。

# tests/test_sample.py
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

def test_example_title(driver):
    """example.comのタイトルが正しく取得できるか確認"""
    driver.get("https://example.com")
    assert "Example Domain" in driver.title

def test_example_heading(driver):
    """example.comの見出しが表示されるまで待機して確認（実務レベルの書き方）"""
    driver.get("https://example.com")
    # WebDriverWait：要素が表示されるまで最大10秒待機（実務必須）
    # visibility_of_element_located = DOMにあり、かつ画面に表示されていることを確認
    heading = WebDriverWait(driver, 10).until(
        EC.visibility_of_element_located((By.TAG_NAME, "h1"))
    )
    assert heading.is_displayed()

テストの実行

pytest

実行結果サンプル

========================== test session starts ==========================
platform darwin -- Python 3.11.5, pytest-7.4.0, selenium-4.18.1
collected 2 items

tests/test_sample.py::test_example_title    PASSED  [ 50%]
tests/test_sample.py::test_example_heading  PASSED  [100%]

========================== 2 passed in 3.21s ===========================

⚠️ よくあるエラーと解決策

# 解決策：webdriver-managerを使っていれば自動解決
# キャッシュが古い場合は削除して再インストール
pip install --upgrade webdriver-manager

# 解決策：仮想環境を有効化してから再インストール
source venv/bin/activate  # Mac/Linux
venv\Scripts\activate     # Windows
pip install selenium webdriver-manager

# NG
def check_google(driver):  # test_ がない

# OK
def test_google_title(driver):  # test_ が必要

from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By

# 最大10秒待機して要素が表示されるまで待つ
element = WebDriverWait(driver, 10).until(
    EC.presence_of_element_located((By.NAME, "q"))
)

SeleniumとPlaywrightの使い分けとは？

どちらを選ぶか迷う方向けに整理します。

FAQ

この記事の手順通りに進めれば、環境構築で詰まることはありません。万が一エラーが出た場合は上の「よくあるエラーと解決策」を参照してください。

📋 この記事のまとめ

まずは pytest で2つのテストが PASSED になることを確認しましょう。環境が動いてしまえば、あとはテストケースを追加していくだけです。次のステップとして、ログインフォームのバリデーションテストや Page Object Model パターンの実装に進んでみてください。