Python 自動(dòng)化測試環(huán)境搭建指南（小白友好版）
一、核心說明
本文檔覆蓋 UI自動(dòng)化（Selenium） + 接口自動(dòng)化（Requests） + 測試框架（Pytest） 全環(huán)境，步驟按「從基礎(chǔ)到工具」順序排列，每個(gè)操作附截圖提示和常見問題解決，零基礎(chǔ)也能完成。
二、前置準(zhǔn)備
? 操作系統(tǒng)：Windows 10/11（推薦）、MacOS（步驟通用，終端操作略有差異）
? 網(wǎng)絡(luò)：需聯(lián)網(wǎng)下載軟件和依賴包
? 工具：無額外預(yù)裝要求，按步驟逐步安裝即可
三、步驟1：安裝Python（必裝）
1.1 下載Python
? 打開官網(wǎng)：https://www.python.org/downloads/
? 點(diǎn)擊「Download Python 3.11.x」（推薦3.11版本，穩(wěn)定兼容所有自動(dòng)化工具，不要選3.12+避免兼容性問題）
? 注意：Windows系統(tǒng)選擇「Windows Installer (64-bit)」，MacOS選擇「macOS 64-bit universal2 installer」
1.2 安裝Python（關(guān)鍵步驟，不許漏?。?br>
Windows系統(tǒng)：
- 雙擊下載的.exe文件，勾選「Add Python.exe to PATH」（必須勾選，否則后續(xù)無法使用命令行調(diào)用Python）
- 點(diǎn)擊「Customize installation」，保持默認(rèn)選項(xiàng)（所有組件都勾選），點(diǎn)擊「Next」
- 勾選「Install for all users」，安裝路徑建議默認(rèn)（如C:\Program Files\Python311），點(diǎn)擊「Install」
- 等待安裝完成，點(diǎn)擊「Close」
MacOS系統(tǒng)： - 雙擊.dmg文件，拖動(dòng)Python圖標(biāo)到Applications文件夾
- 打開終端（Launchpad → 其他 → 終端），輸入命令：echo 'export PATH="/Applications/Python 3.11/Contents/MacOS:$PATH"' >> ~/.bash_profile（配置環(huán)境變量）
- 輸入命令：source ~/.bash_profile（生效環(huán)境變量）
1.3 驗(yàn)證Python安裝成功 - 打開命令行工具：
? Windows：按下「Win+R」，輸入cmd，回車
? MacOS：打開終端（Launchpad → 其他 → 終端） - 輸入命令：python --version（Windows）或 python3 --version（MacOS）
- 若顯示「Python 3.11.x」（x為具體版本號(hào)），則安裝成功；若提示「不是內(nèi)部或外部命令」，說明步驟1.2中「Add Python to PATH」未勾選，需重新安裝并勾選該選項(xiàng)。
四、步驟2：安裝代碼編輯器（推薦PyCharm社區(qū)版）
2.1 下載PyCharm
? 打開官網(wǎng)：https://www.jetbrains.com/pycharm/download/
? 點(diǎn)擊「Download」，選擇「Community Edition」（社區(qū)版，免費(fèi)，足夠滿足自動(dòng)化測試需求）
? 對(duì)應(yīng)系統(tǒng)下載：Windows選「Windows」，MacOS選「macOS」
2.2 安裝PyCharm
Windows系統(tǒng)： - 雙擊.exe文件，點(diǎn)擊「Next」
- 安裝路徑建議默認(rèn)（如C:\Program Files\JetBrains\PyCharm Community Edition 2024.1），點(diǎn)擊「Next」
- 勾選「64-bit launcher」「Add launchers dir to PATH」「Create associations → .py」，點(diǎn)擊「Next」
- 點(diǎn)擊「Install」，等待完成后點(diǎn)擊「Finish」
MacOS系統(tǒng)： - 雙擊.dmg文件，拖動(dòng)PyCharm圖標(biāo)到Applications文件夾
- 從Applications中打開PyCharm，首次打開點(diǎn)擊「New Project」驗(yàn)證是否能正常啟動(dòng)
2.3 首次配置PyCharm（關(guān)鍵） - 打開PyCharm，點(diǎn)擊「New Project」
- 「Location」：選擇項(xiàng)目保存路徑（如Windows：D:\AutoTestProject，MacOS：~/Documents/AutoTestProject）
- 「Python Interpreter」：選擇「Previously configured interpreter」，自動(dòng)識(shí)別到步驟1安裝的Python 3.11（若未識(shí)別，點(diǎn)擊「Add Interpreter」→「System Interpreter」→ 選擇Python安裝路徑下的python.exe）
- 勾選「Create a main.py welcome script」，點(diǎn)擊「Create」
- 彈出「Tip of the Day」，關(guān)閉即可，此時(shí)PyCharm已準(zhǔn)備就緒
五、步驟3：安裝自動(dòng)化測試核心依賴包
所有依賴包通過「pip命令」安裝，操作如下：
3.1 打開命令行（或PyCharm終端）
? 方式1：使用系統(tǒng)命令行（Windows cmd / Mac終端）
? 方式2：在PyCharm中，點(diǎn)擊底部「Terminal」（終端），直接在項(xiàng)目內(nèi)執(zhí)行命令（推薦，自動(dòng)關(guān)聯(lián)項(xiàng)目Python環(huán)境）
3.2 安裝依賴包（逐行執(zhí)行命令，不要批量復(fù)制） - 升級(jí)pip（避免安裝失敗）
Windows系統(tǒng)
python -m pip install --upgrade pip
MacOS系統(tǒng)
python3 -m pip install --upgrade pip
- 安裝核心包（按順序執(zhí)行）
1. 接口自動(dòng)化核心：發(fā)送HTTP請(qǐng)求
pip install requests==2.31.0
2. UI自動(dòng)化核心：控制瀏覽器
pip install selenium==4.21.0
3. 測試框架：執(zhí)行測試用例、生成報(bào)告
pip install pytest==7.4.4
4. 測試報(bào)告生成：美觀的HTML報(bào)告
pip install pytest-html==3.2.0
5. 控制瀏覽器驅(qū)動(dòng)（自動(dòng)下載對(duì)應(yīng)版本，無需手動(dòng)找驅(qū)動(dòng)）
pip install webdriver-manager==4.0.1
6. 處理Excel（數(shù)據(jù)驅(qū)動(dòng)測試用，可選）
pip install openpyxl==3.1.2
3.3 驗(yàn)證依賴安裝成功
在命令行輸入以下命令，若顯示版本號(hào)則安裝成功：
pip show requests | findstr Version # Windows
pip show requests | grep Version # MacOS
同理可驗(yàn)證其他包：selenium、pytest、webdriver-manager
六、步驟4：配置瀏覽器（UI自動(dòng)化用）
4.1 安裝瀏覽器（推薦Chrome）
? 下載Chrome：https://www.google.com/chrome/（國內(nèi)可通過360瀏覽器官網(wǎng)下載Chrome離線包）
? 安裝后打開Chrome，點(diǎn)擊右上角「三個(gè)點(diǎn)」→「幫助」→「關(guān)于Google Chrome」，查看瀏覽器版本（如126.0.6478.126）
4.2 驗(yàn)證Selenium+Chrome配置
- 打開PyCharm，在main.py中輸入以下代碼：
導(dǎo)入依賴
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager
import time
自動(dòng)下載對(duì)應(yīng)版本的Chrome驅(qū)動(dòng)并啟動(dòng)瀏覽器
driver = webdriver.Chrome(service=Service(ChromeDriverManager().install()))
打開百度（驗(yàn)證瀏覽器是否正常啟動(dòng)）
driver.get("https://www.baidu.com")
停留3秒
time.sleep(3)
關(guān)閉瀏覽器
driver.quit()
- 右鍵點(diǎn)擊代碼，選擇「Run 'main'」
- 若能自動(dòng)打開Chrome瀏覽器并訪問百度，3秒后關(guān)閉，則配置成功；若失敗，參考「常見問題解決」。
七、步驟5：驗(yàn)證全環(huán)境可用（最終測試）
5.1 接口自動(dòng)化測試驗(yàn)證
在PyCharm中新建文件「test_api.py」，輸入以下代碼：
import requests
import pytest
測試百度接口是否可用
def test_baidu_api():
# 發(fā)送GET請(qǐng)求
response = requests.get("https://www.baidu.com")
# 斷言狀態(tài)碼為200（表示請(qǐng)求成功）
assert response.status_code == 200
print("接口自動(dòng)化測試通過！")
if name == "main":
pytest.main(["-v", "test_api.py"])
右鍵運(yùn)行，若控制臺(tái)顯示「PASSED」，則接口自動(dòng)化環(huán)境正常。
5.2 UI自動(dòng)化測試驗(yàn)證
在PyCharm中新建文件「test_ui.py」，輸入以下代碼：
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager
from selenium.webdriver.common.by import By
import pytest
def test_baidu_search():
# 啟動(dòng)Chrome瀏覽器
driver = webdriver.Chrome(service=Service(ChromeDriverManager().install()))
driver.implicitly_wait(10) # 等待元素加載（最多10秒）
# 打開百度
driver.get("https://www.baidu.com")
# 輸入搜索關(guān)鍵詞「自動(dòng)化測試」
driver.find_element(By.ID, "kw").send_keys("自動(dòng)化測試")
# 點(diǎn)擊搜索按鈕
driver.find_element(By.ID, "su").click()
# 斷言搜索結(jié)果頁標(biāo)題包含「自動(dòng)化測試」
assert "自動(dòng)化測試" in driver.title
print("UI自動(dòng)化測試通過！")
# 關(guān)閉瀏覽器
driver.quit()
if name == "main":
pytest.main(["-v", "test_ui.py"])
右鍵運(yùn)行，若能自動(dòng)完成搜索操作，控制臺(tái)顯示「PASSED」，則UI自動(dòng)化環(huán)境正常。
5.3 測試報(bào)告生成驗(yàn)證
在PyCharm終端輸入以下命令：
pytest test_ui.py --html=test_report.html
執(zhí)行完成后，在項(xiàng)目文件夾中會(huì)生成「test_report.html」文件，雙擊打開，若能看到美觀的測試報(bào)告（包含用例執(zhí)行結(jié)果、耗時(shí)等），則全環(huán)境配置成功！
八、常見問題解決（小白必看）
問題1：Python安裝后，命令行輸入python提示「不是內(nèi)部或外部命令」
? 原因：安裝時(shí)未勾選「Add Python.exe to PATH」
? 解決：重新運(yùn)行Python安裝包，勾選該選項(xiàng)；若已安裝，手動(dòng)配置環(huán)境變量（百度「Windows/Mac Python環(huán)境變量配置」，按步驟添加Python安裝路徑和Scripts路徑）
問題2：pip安裝包時(shí)提示「Read timed out」
? 原因：網(wǎng)絡(luò)問題，默認(rèn)鏡像源在國外
? 解決：使用國內(nèi)鏡像源安裝（以安裝requests為例）
pip install requests==2.31.0 -i https://pypi.tuna.tsinghua.edu.cn/simple
問題3：Selenium啟動(dòng)Chrome失敗，提示「ChromeDriver executable needs to be in PATH」
? 原因：未使用webdriver-manager，手動(dòng)配置驅(qū)動(dòng)版本不匹配
? 解決：確保已安裝webdriver-manager（pip install webdriver-manager），并使用步驟4.2中的代碼（通過ChromeDriverManager自動(dòng)下載驅(qū)動(dòng)）
問題4：PyCharm中運(yùn)行代碼提示「No module named 'selenium'」
? 原因：PyCharm的Python解釋器未關(guān)聯(lián)安裝依賴的環(huán)境
? 解決：點(diǎn)擊PyCharm右下角「Python 3.11」→「Interpreter Settings」→ 確認(rèn)解釋器是步驟1安裝的Python（如C:\Program Files\Python311\python.exe），若不是則切換
問題5：Chrome瀏覽器版本過高，webdriver-manager無法下載對(duì)應(yīng)驅(qū)動(dòng)
? 解決：降級(jí)Chrome瀏覽器到穩(wěn)定版本（如126版本），或更新webdriver-manager（pip install --upgrade webdriver-manager）
九、環(huán)境搭建成功標(biāo)準(zhǔn)
- 命令行輸入python --version（Windows）/ python3 --version（Mac），顯示3.11.x版本
- PyCharm能正常運(yùn)行Python代碼，導(dǎo)入requests、selenium、pytest無報(bào)錯(cuò)
- 執(zhí)行test_ui.py能自動(dòng)啟動(dòng)Chrome并完成百度搜索
- 執(zhí)行pytest命令能生成HTML測試報(bào)告
需要我?guī)湍闵梢环荨缸詣?dòng)化測試環(huán)境搭建操作截圖手冊(cè)」嗎？包含每個(gè)步驟的關(guān)鍵截圖和鼠標(biāo)點(diǎn)擊位置標(biāo)注，小白能更直觀跟著操作。
(豆包AI生成)
