Python 自动化测试环境搭建指南（小白友好版）
一、核心说明
本文档覆盖 UI自动化（Selenium） + 接口自动化（Requests） + 测试框架（Pytest）全环境，步骤按「从基础到工具」顺序排列，每个操作附截图提示和常见问题解决，零基础也能完成。
二、前置准备
• 操作系统：Windows 10/11（推荐）、MacOS（步骤通用，终端操作略有差异）
• 网络：需联网下载软件和依赖包
• 工具：无额外预装要求，按步骤逐步安装即可
三、步骤1：安装Python（必装）
1.1 下载Python
• 打开官网：https://www.python.org/downloads/
• 点击「Download Python 3.11.x」（推荐3.11版本，稳定兼容所有自动化工具，不要选3.12+避免兼容性问题）
• 注意：Windows系统选择「Windows Installer (64-bit)」，MacOS选择「macOS 64-bit universal2 installer」
1.2 安装Python（关键步骤，不许漏！）
Windows系统：

双击下载的.exe文件，勾选「Add Python.exe to PATH」（必须勾选，否则后续无法使用命令行调用Python）
点击「Customize installation」，保持默认选项（所有组件都勾选），点击「Next」
勾选「Install for all users」，安装路径建议默认（如C:\Program Files\Python311），点击「Install」
等待安装完成，点击「Close」
MacOS系统：
双击.dmg文件，拖动Python图标到Applications文件夹
打开终端（Launchpad → 其他 → 终端），输入命令：echo 'export PATH="/Applications/Python 3.11/Contents/MacOS:$PATH"' >> ~/.bash_profile（配置环境变量）
输入命令：source ~/.bash_profile（生效环境变量）
1.3 验证Python安装成功
打开命令行工具：
◦ Windows：按下「Win+R」，输入cmd，回车
◦ MacOS：打开终端（Launchpad → 其他 → 终端）
输入命令：python --version（Windows）或 python3 --version（MacOS）
若显示「Python 3.11.x」（x为具体版本号），则安装成功；若提示「不是内部或外部命令」，说明步骤1.2中「Add Python to PATH」未勾选，需重新安装并勾选该选项。
四、步骤2：安装代码编辑器（推荐PyCharm社区版）
2.1 下载PyCharm
• 打开官网：https://www.jetbrains.com/pycharm/download/
• 点击「Download」，选择「Community Edition」（社区版，免费，足够满足自动化测试需求）
• 对应系统下载：Windows选「Windows」，MacOS选「macOS」
2.2 安装PyCharm
Windows系统：
双击.exe文件，点击「Next」
安装路径建议默认（如C:\Program Files\JetBrains\PyCharm Community Edition 2024.1），点击「Next」
勾选「64-bit launcher」「Add launchers dir to PATH」「Create associations → .py」，点击「Next」
点击「Install」，等待完成后点击「Finish」
MacOS系统：
双击.dmg文件，拖动PyCharm图标到Applications文件夹
从Applications中打开PyCharm，首次打开点击「New Project」验证是否能正常启动
2.3 首次配置PyCharm（关键）
打开PyCharm，点击「New Project」
「Location」：选择项目保存路径（如Windows：D:\AutoTestProject，MacOS：~/Documents/AutoTestProject）
「Python Interpreter」：选择「Previously configured interpreter」，自动识别到步骤1安装的Python 3.11（若未识别，点击「Add Interpreter」→「System Interpreter」→ 选择Python安装路径下的python.exe）
勾选「Create a main.py welcome script」，点击「Create」
弹出「Tip of the Day」，关闭即可，此时PyCharm已准备就绪
五、步骤3：安装自动化测试核心依赖包
所有依赖包通过「pip命令」安装，操作如下：
3.1 打开命令行（或PyCharm终端）
• 方式1：使用系统命令行（Windows cmd / Mac终端）
• 方式2：在PyCharm中，点击底部「Terminal」（终端），直接在项目内执行命令（推荐，自动关联项目Python环境）
3.2 安装依赖包（逐行执行命令，不要批量复制）
升级pip（避免安装失败）

Windows系统

python -m pip install --upgrade pip

MacOS系统

python3 -m pip install --upgrade pip

安装核心包（按顺序执行）

1. 接口自动化核心：发送HTTP请求

pip install requests==2.31.0

2. UI自动化核心：控制浏览器

pip install selenium==4.21.0

3. 测试框架：执行测试用例、生成报告

pip install pytest==7.4.4

4. 测试报告生成：美观的HTML报告

pip install pytest-html==3.2.0

5. 控制浏览器驱动（自动下载对应版本，无需手动找驱动）

pip install webdriver-manager==4.0.1

6. 处理Excel（数据驱动测试用，可选）

pip install openpyxl==3.1.2
3.3 验证依赖安装成功
在命令行输入以下命令，若显示版本号则安装成功：

pip show requests | findstr Version # Windows
pip show requests | grep Version # MacOS

同理可验证其他包：selenium、pytest、webdriver-manager

六、步骤4：配置浏览器（UI自动化用）
4.1 安装浏览器（推荐Chrome）
• 下载Chrome：https://www.google.com/chrome/（国内可通过360浏览器官网下载Chrome离线包）
• 安装后打开Chrome，点击右上角「三个点」→「帮助」→「关于Google Chrome」，查看浏览器版本（如126.0.6478.126）
4.2 验证Selenium+Chrome配置

打开PyCharm，在main.py中输入以下代码：

导入依赖

from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager
import time

自动下载对应版本的Chrome驱动并启动浏览器

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

打开百度（验证浏览器是否正常启动）

driver.get("https://www.baidu.com")

停留3秒

time.sleep(3)

关闭浏览器

driver.quit()

右键点击代码，选择「Run 'main'」
若能自动打开Chrome浏览器并访问百度，3秒后关闭，则配置成功；若失败，参考「常见问题解决」。
七、步骤5：验证全环境可用（最终测试）
5.1 接口自动化测试验证
在PyCharm中新建文件「test_api.py」，输入以下代码：

import requests
import pytest

测试百度接口是否可用

def test_baidu_api():
# 发送GET请求
response = requests.get("https://www.baidu.com")
# 断言状态码为200（表示请求成功）
assert response.status_code == 200
print("接口自动化测试通过！")
if name == "main":
pytest.main(["-v", "test_api.py"])
右键运行，若控制台显示「PASSED」，则接口自动化环境正常。
5.2 UI自动化测试验证
在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():
# 启动Chrome浏览器
driver = webdriver.Chrome(service=Service(ChromeDriverManager().install()))
driver.implicitly_wait(10) # 等待元素加载（最多10秒）
# 打开百度
driver.get("https://www.baidu.com")
# 输入搜索关键词「自动化测试」
driver.find_element(By.ID, "kw").send_keys("自动化测试")
# 点击搜索按钮
driver.find_element(By.ID, "su").click()
# 断言搜索结果页标题包含「自动化测试」
assert "自动化测试" in driver.title
print("UI自动化测试通过！")
# 关闭浏览器
driver.quit()
if name == "main":
pytest.main(["-v", "test_ui.py"])
右键运行，若能自动完成搜索操作，控制台显示「PASSED」，则UI自动化环境正常。
5.3 测试报告生成验证
在PyCharm终端输入以下命令：

pytest test_ui.py --html=test_report.html
执行完成后，在项目文件夹中会生成「test_report.html」文件，双击打开，若能看到美观的测试报告（包含用例执行结果、耗时等），则全环境配置成功！
八、常见问题解决（小白必看）
问题1：Python安装后，命令行输入python提示「不是内部或外部命令」
• 原因：安装时未勾选「Add Python.exe to PATH」
• 解决：重新运行Python安装包，勾选该选项；若已安装，手动配置环境变量（百度「Windows/Mac Python环境变量配置」，按步骤添加Python安装路径和Scripts路径）
问题2：pip安装包时提示「Read timed out」
• 原因：网络问题，默认镜像源在国外
• 解决：使用国内镜像源安装（以安装requests为例）

pip install requests==2.31.0 -i https://pypi.tuna.tsinghua.edu.cn/simple
问题3：Selenium启动Chrome失败，提示「ChromeDriver executable needs to be in PATH」
• 原因：未使用webdriver-manager，手动配置驱动版本不匹配
• 解决：确保已安装webdriver-manager（pip install webdriver-manager），并使用步骤4.2中的代码（通过ChromeDriverManager自动下载驱动）
问题4：PyCharm中运行代码提示「No module named 'selenium'」
• 原因：PyCharm的Python解释器未关联安装依赖的环境
• 解决：点击PyCharm右下角「Python 3.11」→「Interpreter Settings」→ 确认解释器是步骤1安装的Python（如C:\Program Files\Python311\python.exe），若不是则切换
问题5：Chrome浏览器版本过高，webdriver-manager无法下载对应驱动
• 解决：降级Chrome浏览器到稳定版本（如126版本），或更新webdriver-manager（pip install --upgrade webdriver-manager）
九、环境搭建成功标准

命令行输入python --version（Windows）/ python3 --version（Mac），显示3.11.x版本
PyCharm能正常运行Python代码，导入requests、selenium、pytest无报错
执行test_ui.py能自动启动Chrome并完成百度搜索
执行pytest命令能生成HTML测试报告

需要我帮你生成一份「自动化测试环境搭建操作截图手册」吗？包含每个步骤的关键截图和鼠标点击位置标注，小白能更直观跟着操作。
(豆包AI生成)

2025-12-04