Python Selenium 超详细新手教程:从零开始掌握浏览器自动化
以下是 Python + Selenium 超详细新手教程(2026 年最新版):从零开始掌握浏览器自动化。
这份教程基于 Selenium 4.40+(2026 年 1 月最新稳定版)和 Python 3.12/3.13,重点解决新手最痛的几个问题:
- 驱动安装不再手动下载(Selenium Manager 自动搞定)
- headless / 无头模式 / 绕过检测
- 常见元素定位、等待、交互、异常处理
- 真实项目场景示例(登录、爬取、表单填写、截图等)
0. 为什么 2026 年还在学 Selenium?
- 动态 JS 页面、复杂交互、文件上传、验证码绕过等场景,Playwright / Puppeteer 虽快,但 Selenium 生态最成熟、职位最多、云测试平台支持最好。
- Selenium Manager(4.6+ 内置)让安装难度大幅降低,新手友好度暴涨。
1. 环境准备(5 分钟搞定)
步骤 1:安装 Selenium(包含 Selenium Manager)
pip install --upgrade selenium # 推荐额外安装(方便调试、等待、日志) pip install webdriver-manager # 可选,Selenium Manager 已够用,但有时更稳定步骤 2:验证安装
from selenium import webdriver print(webdriver.__version__)# 应该 ≥ 4.40.02026 年关键变化:
- Selenium 4.6+ 内置 Selenium Manager(Rust 实现),自动下载匹配你浏览器版本的 chromedriver/geckodriver/msedgedriver 等。
- 不再需要手动去 chromedriver.chromium.org 下载驱动,也不用放 PATH。
2. 第一个程序:打开浏览器 + 访问页面
from selenium import webdriver from selenium.webdriver.chrome.options import Options # ------------------- 方式一:最简单(推荐新手) ------------------- driver = webdriver.Chrome()# 自动使用 Selenium Manager 下载驱动 driver.get("https://www.python.org")print(driver.title)# Python.org 标题 driver.quit()# 必须关闭,否则进程残留方式二:无头模式(headless)——后台运行,不弹出窗口
options = Options() options.add_argument("--headless=new")# 现代无头模式(Chrome 109+ 推荐) options.add_argument("--disable-gpu")# 部分系统需要 options.add_argument("--no-sandbox")# Linux / Docker 常见 options.add_argument("--disable-dev-shm-usage") driver = webdriver.Chrome(options=options) driver.get("https://www.google.com")print(driver.page_source[:200])# 输出部分 HTML driver.quit()方式三:加一些防检测参数(爬虫/防反爬常用)
options = Options() options.add_argument("--headless=new") options.add_argument("user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36") options.add_experimental_option("excludeSwitches",["enable-automation"]) options.add_experimental_option('useAutomationExtension',False) driver = webdriver.Chrome(options=options)3. 核心概念:元素定位(8 大主流方式)
| 定位方式 | 语法示例 | 适用场景 | 优先级建议 |
|---|---|---|---|
| id | find_element(By.ID, “kw”) | 最高优先,唯一性强 | ★★★★★ |
| name | find_element(By.NAME, “wd”) | 表单 input name | ★★★★☆ |
| class name | find_element(By.CLASS_NAME, “s_ipt”) | 单个 class | ★★★☆☆ |
| tag name | find_elements(By.TAG_NAME, “a”) | 找所有链接/按钮 | ★★☆☆☆ |
| link text | find_element(By.LINK_TEXT, “新闻”) | 精确匹配超链接文字 | ★★★☆☆ |
| partial link text | find_element(By.PARTIAL_LINK_TEXT, “新”) | 模糊匹配链接文字 | ★★☆☆☆ |
| css selector | find_element(By.CSS_SELECTOR, “#kw”) .s_ipt input[type=‘text’] | 最强大、最快、推荐掌握 | ★★★★★ |
| xpath | find_element(By.XPATH, “//*[@id=‘kw’]”) //input[@name=‘wd’] | 最灵活,但慢、易碎 | ★★★★☆ |
推荐顺序(2026 年最佳实践):
ID > name > css > xpath(最后用) > class > link text
from selenium import webdriver from selenium.webdriver.common.by import By from selenium.webdriver.common.keys import Keys import time driver = webdriver.Chrome() driver.get("https://www.baidu.com")# 定位搜索框(多种写法等价) search_box = driver.find_element(By.ID,"kw")# search_box = driver.find_element(By.NAME, "wd")# search_box = driver.find_element(By.CSS_SELECTOR, "#kw")# search_box = driver.find_element(By.XPATH, "//input[@id='kw']") search_box.clear()# 清空 search_box.send_keys("Python Selenium 教程") search_box.send_keys(Keys.ENTER)# 回车搜索 time.sleep(3)# 粗暴等待(后面学智能等待)print(driver.title) driver.quit()4. 必须掌握:显式等待(WebDriverWait)——避免 sleep 地狱
from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC wait = WebDriverWait(driver, timeout=10, poll_frequency=0.5)# 每0.5秒检查一次,最多等10秒# 等待元素可见 wait.until(EC.visibility_of_element_located((By.ID,"result_logo")))# 等待元素可点击 wait.until(EC.element_to_be_clickable((By.CSS_SELECTOR,".btn.btn-primary")))# 等待标题包含某文字 wait.until(EC.title_contains("Python"))常用 EC(expected_conditions):
- visibility_of_element_located
- presence_of_element_located(在 DOM 中即可,不必可见)
- element_to_be_clickable
- text_to_be_present_in_element
- title_is / title_contains
- staleness_of(元素消失)
5. 常见交互操作汇总
element = driver.find_element(By.ID,"su") element.click()# 点击 element.send_keys("输入内容")# 输入 element.clear()# 清空输入框 element.get_attribute("value")# 获取 value 属性 element.text # 获取显示文本 element.is_displayed()# 是否可见 element.is_enabled()# 是否可用 element.is_selected()# radio/checkbox 是否选中# 浏览器操作 driver.back() driver.forward() driver.refresh() driver.maximize_window() driver.set_window_size(1200,800) driver.save_screenshot("baidu.png")# 截图6. 窗口/iframe/警报处理
# 切换窗口(多标签) handles = driver.window_handles driver.switch_to.window(handles[1])# 切换到第二个标签# 切换 iframe driver.switch_to.frame("iframe_id_or_name_or_element") driver.switch_to.default_content()# 切回主文档# 处理 alert/confirm/prompt alert = driver.switch_to.alert alert.accept()# 确认 alert.dismiss()# 取消 alert.text # 获取弹窗文字 alert.send_keys("输入")# prompt 输入7. 真实项目小实战:自动登录某网站(伪代码)
driver = webdriver.Chrome() wait = WebDriverWait(driver,15) driver.get("https://example.com/login") wait.until(EC.presence_of_element_located((By.NAME,"username"))).send_keys("your_account") driver.find_element(By.NAME,"password").send_keys("your_pass") driver.find_element(By.CSS_SELECTOR,"button[type='submit']").click()# 等待登录成功(例如个人中心元素出现) wait.until(EC.presence_of_element_located((By.CLASS_NAME,"user-avatar")))print("登录成功!") driver.save_screenshot("login_success.png")8. 常见报错 & 解决方案(2026 年高频)
| 错误 | 原因 & 解决办法 |
|---|---|
| NoSuchDriverException | 浏览器版本与驱动不匹配 → 升级 selenium 或用 webdriver-manager 强制更新 |
| ElementNotInteractableException | 元素被遮挡/不可见 → 加等待 + scrollIntoView 或 ActionChains 移动鼠标 |
| StaleElementReferenceException | 页面刷新后元素失效 → 重新定位元素,不要缓存 element |
| TimeoutException | 等待超时 → 延长 timeout 或检查 locator 是否正确 |
| SessionNotCreatedException | 驱动版本错 → Selenium Manager 自动处理,若失败:options.add_argument(“–headless=new”) |
| undetected-chromedriver 检测 | 网站强反爬 → 用 undetected-chromedriver 库(pip install undetected-chromedriver) |
9. 进阶方向建议(学完基础后)
- Page Object Model(POM)设计模式
- pytest + selenium 集成(推荐测试框架)
- 处理验证码(OCR / 人工打码平台)
- 多线程/分布式(selenium-grid)
- 结合 Playwright 迁移(未来趋势)
- headless + proxy + user-agent 随机 → 爬虫防封
一句话总结:
2026 年 Selenium 安装几乎零成本(Selenium Manager 功不可没),学会 显式等待 + CSS 定位 + POM,你就基本能应对 90% 的浏览器自动化需求。
有哪部分还想再细讲?
例如:
- 如何处理滑块验证码
- POM 完整项目模板
- headless + 绕过 Cloudflare / Akamai
- pytest + allure 报告
随时告诉我,我继续展开~