“你装三遍还是报错不是因为笨而是每一步踩的坑没人提前告诉你。”很多刚开始学自动化的人第一步都栽在同一件事上照着网上的教程装 PyCharm、Python、Selenium装完一运行满屏红字。模块明明装过却说找不到驱动也下了但版本对不上好不容易跑起来又卡在“找不到元素”。我把从空白环境到跑通第一个自动化脚本的完整过程包含我自己踩过的每一个坑整理成这份实操教程。核心就一件事让你花一个下午就能跑通而不是一个周末。全文按安装顺序展开从 Python 版本选择、PyCharm 解释器配置到 Selenium 安装、浏览器驱动版本匹配再到第一个脚本逐行拆解最后是一些高频报错的排查速查。零基础直接照做已经装过但被各种报错劝退的也可以按章节对照排查。1. 这套组合的关系与整体安装顺序1.1 Python、PyCharm、Selenium 各自扮演什么角色先花几分钟把这三个东西的关系搞清楚后面排错会省一大半力气。很多新手一报错就以为 Selenium 没装好其实八成是 Python 环境乱了或者 PyCharm 选错了解释器。Python 是根本。它是一门编程语言你写的自动化脚本本质上就是一段 Python 代码。没有 Python后面两个都无从谈起。PyCharm 是一个编辑器准确说是集成开发环境。它让你写代码更舒服有语法高亮、代码补全、断点调试。它的存在是“提升效率”不是“必需”。你不装 PyCharm用记事本写代码然后在命令行执行理论上也能跑通自动化。但对新手来说PyCharm 的断点调试比到处打印日志友好太多了。我建议老老实实装上。Selenium 是自动化库。它不是一个独立软件而是 Python 的一个第三方库用 pip 安装。它的作用很简单让你用代码控制真实的浏览器去打开网页、点击按钮、填写表单、抓取数据。打个比方Python 是发动机PyCharm 是修车车间Selenium 是机械手臂。发动机提供动力车间方便你操作机械手臂帮你实际动手。你问“我只想要机械手臂行不行”不行因为手臂要靠发动机驱动车间让你看得清手在哪儿、出了什么问题。1.2 Selenium 的工作原理一条链路看懂它Selenium 能控制浏览器靠的可不是魔法。它自己不会打开任何窗口真正打开浏览器的是驱动对 Chrome 来说就是 chromedriverChromeDriver。完整链路是这样的你的脚本 → Selenium 库 → chromedriver.exe → Chrome 浏览器 → 网页每一层都有明确分工。脚本里写的driver.get(某个网址)会被 Selenium 翻译成一条控制命令交给 chromedriverchromedriver 再用 Chrome 支持的调试协议让浏览器真的去访问这个网址。这条链路理解了排错逻辑就清楚了报错发生在哪一段问题就出在哪一段。比如报错说“chromedriver 需要放到 PATH 里”那是链路的第二段断了报错说“ChromeDriver 只支持 Chrome 某个版本”那是驱动和浏览器之间没对上。这也是为什么我强调按顺序安装。很多人先装好了 Chrome 和 PyCharm再回头补 Python最后装 Selenium 的时候已经不知道自己的环境乱成什么样了一报错根本无从查起。按顺序来每一步验证完再走下一步出问题就能快速定位。1.3 推荐的安装顺序与验证节奏我的建议顺序安装 Python 并验证版本安装 PyCharm 并新建项目、确认解释器在项目终端里用 pip 安装 Selenium配置浏览器驱动写一个最小脚本跑通每一步都要做“验证”再往下走。什么是验证装完 Python 后在命令行输入python --version看到版本号输出才算过关。装完 Selenium在终端里执行pip show selenium确认包存在才算过关。别急着一次性装完所有东西再开跑那样一旦报错你根本不知道是哪一个环节出了问题。我自己第一遍就是这个心态结果最后报错的时候花了三个小时逐个排除才意识到是最开始 Python 的 PATH 没勾上。如果当时每步都验证这个坑三分钟就能发现。2. Python 安装新手第一道坎2.1 版本选择与下载方式去 Python 官方网站下载 Windows 安装包选 64 位的版本。现在绝大多数电脑都是 64 位系统除非你的机器特别老否则不要选 32 位。版本怎么选我建议用 Python 3.11 或 3.12都是成熟稳定的版本。不要盲目追新太新的版本可能出现个别第三方库还没适配的情况也不要选太老的版本比如 3.8 以下Selenium 新版本对这类老环境的兼容性已经逐渐放弃了。这里有个细节Selenium 4.x 系列对 Python 版本要求不算苛刻但你后面可能还要装 pandas、requests 等其他库这些库对新版本的跟进速度有差异。选一个“生态普遍支持”的版本而不是“最新”的版本是更稳妥的思路。目前 3.12 是多数库已经完成适配的选择我实际跑下来没什么兼容性问题。下载时注意文件名里的Windows installer (64-bit)不要下成源码包。下载完成后直接双击运行进入安装向导。2.2 安装时必勾的 PATH 选项进入安装界面时第一屏最下面有一个复选框“Add python.exe to PATH”。这个必须勾这是新手踩得最多的坑没有之一。PATH 是什么你可以把它理解成一个“快捷方式目录”。系统在命令行里输入python时会按 PATH 里记录的文件夹一个个去找有没有叫 python 的程序。你不勾选就是把 python.exe 藏在一个系统不知道的角落里之后输入python就会提示“不是内部或外部命令”。如果你能自定义安装路径建议选一个简单的目录比如D:\Python312尽量避免带空格或中文的路径。虽然官方默认路径也能用但默认位置藏在用户目录下之后你找文件、配驱动的时候会多绕一些路。放到一个你记得住的简单目录后面排查问题方便很多。勾上 PATH 之后直接点 Install Now网速和硬盘都够的话一两分钟就能装完。2.3 怎么确认 Python 真的装好了安装完成后按Win R输入cmd回车打开命令行窗口依次输入两条命令python --version pip --version如果分别输出了类似Python 3.12.x和pip 24.x的版本信息说明安装成功。万一提示找不到命令第一反应先检查是不是 PATH 没勾上。重新打开安装程序选择 Modify把 “Add python.exe to PATH” 补勾上就行。另外可以执行where python这条命令会列出系统能找到的所有 python 路径。这个命令在排查“装了两个 Python”时特别有用。你可能会看到两条路径一条是你装的另一条可能是某些软件自带的。后面 PyCharm 选解释器的时候要小心选到你真正想要的那个。这里要专门提醒一个特别容易误导新手的概念命令行里的 python 和 PyCharm 里的 python不一定是同一个。后面 Selenium “找不到模块”的报错很多都是因为这个错位。所以每新建一个项目都要确认 PyCharm 到底用的是哪个解释器。3. PyCharm 安装与项目解释器配置3.1 用哪个版本社区版足够吗PyCharm 有两个版本社区版Community和专业版Professional。社区版是免费的专业版收费有 30 天试用。做 Selenium 自动化社区版完全够用。注意我的措辞是“完全够用”不是“勉强能用”。项目创建、代码编辑、终端运行、断点调试这些核心功能社区版都有。专业版多的主要是 Web 开发框架支持、远程部署、数据库工具这些跟入门自动化基本没关系。别一开始就为IDE花钱先把自动化跑起来再说。从官网下载社区版安装包装的时候一路默认就行。首次启动会让你选主题配色选个顺眼的然后进到欢迎界面点击 New Project 新建项目。3.2 新建项目时的关键选择新建项目界面里最重要的一个区域是 “New environment using” 或者叫 “Project Interpreter”。对新手来说这里默认的选项基本不用动但要理解它在干什么。它的实质是告诉 PyCharm接下来用哪一个 Python 程序来执行你的代码。这个选择决定了三件事代码运行时用哪个 Python、pip 安装的包装到哪里、import 的时候从哪些目录找库。任何一个错了都会出现“模块找不到”的诡异问题。默认情况下PyCharm 会基于你安装好的那个 Python 版本自动创建一个 venv 虚拟环境。如果你的机器上只有刚才装的一个 Python那这里显示的就是Python 3.12直接认可即可。我见过很多新手在这个界面反复纠结甚至手动去选别的路径结果选了一个别的软件自带的 Python后续各种诡异报错。最好的做法是保持默认确保它显示的是你刚装的那个版本。如果你装了多个 Python下拉开菜单确认选到正确的那一个。3.3 虚拟环境 venv 到底是个什么东西venv 是 Python 自带的一个工具中文叫虚拟环境。它的作用是给每个项目开一个独立的“小房间”房间里有一套自己的 Python 解释器和自己的包仓库。为什么需要它因为不同项目可能依赖不同版本的库。A 项目需要 Selenium 4.6B 项目可能因为老代码只能用 Selenium 3.14。如果都装到全局环境就会互相打架。有了虚拟环境各用各的互不干扰。PyCharm 新建项目时会自动在项目目录下生成一个venv文件夹。所以你不需要手动创建任何环境但你要知道这个文件夹是干什么的。你通过 PyCharm 终端执行pip install selenium时装进去的位置就是这个 venv 文件夹里的 site-packages 目录而不是你计算机的全局环境。什么时候会出问题当你在“系统命令行”里执行pip install selenium而 PyCharm 项目用的是 venv那你装的包和项目用的环境就不是同一个。你说“我明明装了”但代码一运行还是ModuleNotFoundError。解决办法很简单所有安装操作一律在 PyCharm 底部自带的 Terminal 窗口里执行。这个窗口默认就激活了当前项目的虚拟环境装的包绝对没错。4. Selenium 安装与浏览器驱动的版本陷阱4.1 装 Selenium必须在 PyCharm 的终端里执行Selenium 的安装命令就一行pip install selenium但执行它的位置决定了你成不成功。一定在 PyCharm 底部的 Terminal 里执行。PyCharm 创建项目后左下角或底部有一个 “Terminal” 标签点开就是命令行界面。那个界面已经自动进入了当前项目的虚拟环境在这里执行 pip install装的东西百分之百归这个项目用。如果你嫌默认源下载慢国内网络环境下经常卡在等待下载可以临时加镜像源参数pip install selenium -i https://镜像站地址/simple更省事的做法是给 pip 配一个默认的国内镜像源这样以后装任何包都不用每次带参数。具体做法是在用户目录下新建一个 pip 配置文件写入镜像地址。镜像站地址网上搜“pip 国内镜像”选个稳定的用就行。这是常规提速操作不是绕路就是换一个离你更近的下载源。装完之后在终端里执行pip show selenium能看到版本信息和安装位置就说明进入到这个项目的环境里了。也可以跑一句python -c import selenium; print(selenium.__version__)能打印出版本号就是真正可用的状态。4.2 ChromeDriver 为什么老是对不上版本安装完 Selenium脚本还跑不起来因为 Selenium 本身不含浏览器。它只负责发指令真正执行指令的是浏览器驱动。以 Chrome 浏览器为例这个驱动叫 chromedriver或 ChromeDriver。版本匹配是整个 Selenium 配置里最大的一个坑ChromeDriver 的版本必须和 Chrome 浏览器的版本对应上。主版本号不一致就会直接报错。Chrome 有个臭名昭著的特性默认自动更新。你晚上睡觉的时候Chrome 悄悄从 121 升到了 122第二天你打开脚本之前能跑的驱动立刻失配。这是无数人反复踩坑的根源。怎么查版本打开 Chrome点右上角三个点 → 帮助 → 关于 Google Chrome弹出的页面里会显示版本号比如122.0.xxxx.xx。你要下载的 chromedriver 主版本号也必须是 122 开头的小版本号通常对应关系没那么严格主版本对上了基本就能用。下载 chromedriver 有两条正常渠道一个是 Chrome for Testing 的官方下载页它会列出各版本对应的驱动另一个是各类国内镜像站下载速度快一些。下载下来的是一个压缩包解压后得到chromedriver.exe就这么一个文件。4.3 让 webdriver-manager 帮你管理驱动手动管理驱动太痛苦了浏览器一自动升级就失配。我强烈建议新手直接用webdriver-manager这个库它能自动检测你本机 Chrome 的版本然后去匹配的地址下载对应驱动并缓存到本地以后再也不用手动管版本。安装pip install webdriver-manager代码里这么写from selenium import webdriver from selenium.webdriver.chrome.service import Service from webdriver_manager.chrome import ChromeDriverManager service Service(ChromeDriverManager().install()) driver webdriver.Chrome(serviceservice)第一次运行时它会检测 Chrome 版本、下载对应的 chromedriver 并缓存可能需要十几秒。之后再运行直接使用缓存的驱动基本毫秒级启动。实测下来非常稳这是我踩完版本匹配的坑之后一直在用的方案。有人可能会问这不又多了一个依赖吗是的但带来的好处是彻底摆脱手动维护驱动的噩梦对新手来说这个权衡非常划算。等以后你熟练了知道怎么手动管版本再根据自己的场景选方案不迟。4.4 驱动路径的三种接法如果你还是想手动管理 chromedriver驱动路径有三种常见的接法。第一种把chromedriver.exe放到和你的脚本同一个目录然后直接写driver webdriver.Chrome()。Selenium 会按默认规则在当前目录找。但我得说实话这个方式在你的编辑器“运行目录”和脚本目录不一致时经常莫名其妙找不到不建议新手用。第二种显式指定驱动路径这是我最推荐的方式。代码里指定Serviceservice Service(rD:\tools\chromedriver.exe) driver webdriver.Chrome(serviceservice)Windows 路径里的反斜杠是转义符所以要么用原生字符串r...要么写成双反斜杠D:\\tools\\chromedriver.exe。新手最容易在这里踩坑路径写对了但忘了解压驱动或者解压后文件名其实叫chromedriver.exe但你写成了chromedriver。用绝对路径最清晰报错去看也知道该检查哪里。第三种把驱动所在目录加进系统 PATH 环境变量。文件资源管理器 → 右键此电脑 → 属性 → 高级系统设置 → 环境变量 → 在 Path 里新建一行把chromedriver.exe所在文件夹的路径填进去。配完之后代码里可以直接webdriver.Chrome()不用指定路径。这种做法适合你以后要写很多脚本、不想每个都写路径的场景。但对新手来说修改系统级 PATH 有一定风险改错了可能影响别的软件所以我一般建议先用显式路径以后再考虑。5. 第一个自动化脚本从空文件到跑通5.1 新建项目和 Python 文件到这一步环境的基础配置已经完成。打开 PyCharm点击 New ProjectLocation 填你的项目路径例如D:\my_selenium_demoEnvironment 保持默认的 venvCreate 创建项目。项目创建后在左侧项目目录上右键 → New → Python File输入文件名demo回车。PyCharm 会自动帮你创建一个demo.py文件后缀不用手动加。5.2 脚本代码逐行拆解第一个脚本别贪多目标就是“打开一个浏览器访问一个网页停两秒关闭”。把这段代码复制进去from selenium import webdriver from selenium.webdriver.chrome.service import Service import time # 指定 chromedriver 的路径换成你自己的实际路径 service Service(rD:\tools\chromedriver.exe) # 启动浏览器会弹出一个真实的 Chrome 窗口 driver webdriver.Chrome(serviceservice) # 访问一个示例网站 driver.get(https://example.com) # 等 2 秒让页面载荷完成也方便你观察浏览器状态 time.sleep(2) # 关闭浏览器并退出驱动进程 driver.quit()逐行解释一下你以后写任何 Selenium 脚本开头都是这几行。from selenium import webdriver导入 Selenium 的核心模块之后所有浏览器操作都挂在 webdriver 这个命名空间下。from selenium.webdriver.chrome.service import Service导入驱动管理类它负责把 chromedriver 启动起来并和浏览器建立连接。import time是 Python 自带的时间模块这里只用到 sleep 暂停功能。service Service(rD:\tools\chromedriver.exe)就是前面说的显式指定驱动路径。注意这里的路径必须是你机器上实际保存 chromedriver.exe 的位置不要照抄我的。driver webdriver.Chrome(serviceservice)创建 WebDriver 对象。这行一执行你的屏幕上就会弹出一个新的 Chrome 窗口窗口顶部会有一行提示“Chrome 正受到自动测试软件的控制”这是正常现象。driver.get(https://example.com)让浏览器访问这个网址。example.com 是专门用来测试的示例域名不会因为脚本访问产生安全问题。time.sleep(2)让程序暂停两秒。新手阶段先用这种简单粗暴的等待方式后面讲到显式等待你会明白更好的做法但第一步不必那么讲究。driver.quit()关闭浏览器并结束驱动进程。这行非常重要。只关窗口而省略这行会导致后台残留 chromedriver 进程累积多了会占用系统资源。5.3 运行、调试与收尾在 PyCharm 里右键demo.py文件选择Run demo。底部会打开 Run 窗口你会看到 Chrome 窗口弹出、访问地址、停留两秒然后自己关闭。整个过程没有红色报错恭喜你的第一个自动化脚本跑通了。如果运行环境里有杀毒软件拦截 chromedriver你可能会看到弹窗需要选择允许。这是个容易被忽略的外部坑。你如果想亲眼看看操作过程可以把time.sleep(2)改成time.sleep(10)或者运行过程中不要手动去关浏览器窗口让脚本自己走完。跑通这个最简脚本后再试着加一点交互逻辑比如搜索关键词。假设页面上有一个输入框 id 是search-input一个按钮 id 是search-btn代码可以这样from selenium.webdriver.common.by import By driver.find_element(By.ID, search-input).send_keys(自动化) driver.find_element(By.ID, search-btn).click() time.sleep(3) driver.quit()这里第一次接触到find_element它是定位页面元素的入口。By.ID表示按元素 id 查找。这是 Selenium 最常用的操作之一后面你会反复用到。调试方面建议早点学会断点调试。在行号右侧点一下会出现一个红点这就是断点。然后点击右上角的 Debug 图标长得像一只虫子运行程序执行到断点那一行就会暂停。你可以高亮悬停变量查看值也可以点“Step Over”单步执行。这比到处写 print 观察变量高效得多。6. 高频报错排查实录6.1 报错信息速查表我把运行 Selenium 脚本最常见的报错整理成一张速查表你遇到问题先对照它大多数情况能直接解决。报错信息片段真正原因解决办法ModuleNotFoundError: No module named seleniumSelenium 没装进当前项目环境或解释器指向错误在 PyCharm 的 Terminal 里执行 pip install selenium检查右下角解释器路径chromedriver executable needs to be in PATH找不到 chromedriver 程序用 Service 显式指定 chromedriver.exe 的绝对路径This version of ChromeDriver only supports Chrome version xx驱动和 Chrome 版本不匹配改用 webdriver-manager 自动匹配或手动下载对应版本[WinError 2] 系统找不到指定的文件驱动路径写错、路径不存在或驱动没解压检查 Service 里的路径是否真实存在确认压缩包已解压NoSuchElementException页面没有你要找的元素或元素还没加载出来检查元素的 id/class 是否写对改用显式等待TimeoutException等待超时元素一直没有出现检查选择器准确性确认页面是否真的包含该元素控制台中文乱码终端编码和脚本编码不一致把 PyCharm 文件编码和终端编码都统一为 UTF-86.2 几个容易误判的排查细节ModuleNotFoundError是最容易误判的。新手会说“我明明装了 Selenium”。这时候先别怀疑 pip 装错了十有八九是解释器的问题。看 PyCharm 右下角如果没有显示 Python 版本号说明还没有设置解释器。操作路径是File → Settings → Project → Python Interpreter把解释器切换到venv里那个 3.12。切换后重启终端再在 Terminal 里pip list看一下有没有 selenium往往就豁然开朗了。还有一个典型的误判是报错只提到chromedriver却在催你配环境变量。其实问题不一定在 PATH而是你的驱动文件根本没放在正确的位置或者路径写错了。显式指定绝对路径能绕开这个排查过程也是我推荐新手用 Service 的原因。SessionNotCreatedException这种带版本号的报错处理逻辑很清晰打开 Chrome 的“关于”页看主版本号再看 chromedriver 的主版本号要么升级驱动要么用 webdriver-manager 自动解决。不要试图去改脚本绕过版本匹配是硬性要求绕不过去。另外注意一个很容易忽略的事脚本跑完以后如果任务管理器里能看到很多残留的 chrome.exe 或 chromedriver.exe 进程说明你的driver.quit()没有在某些异常情况下执行到。写成下面的形式更稳妥try: driver webdriver.Chrome(serviceservice) driver.get(https://example.com) time.sleep(2) finally: driver.quit()finally里的代码无论前面是否报错都会执行这样即使脚本中途异常浏览器也能被正常关闭不会留下僵尸进程。7. 跑通之后几个值得早点知道的事7.1 元素定位的优先级跑通基础脚本后自动化真正的工作量在于精确定位页面元素。定位的方式有很多种但它们之间有优先级。记住这个顺序优先By.ID这是页面设计上理应唯一的属性没有 id 时用By.NAME再不行用By.CSS_SELECTOR最后才用By.XPATH。新手最容易犯的错误是一上来就用 XPath而且是浏览器开发者工具里右键“复制完整 XPath”得到的绝对路径。这种路径长得像html/body/div[2]/form/input[1]页面任何结构调整都会让它失效。我建议你学会写相对路径比如driver.find_element(By.XPATH, //input[placeholder请输入搜索内容])这行代码的意思是查找 page 上任意位置、标签为 input、且 placeholder 属性等于指定内容的那一个元素。比绝对路径健壮得多。实在不确定元素长什么样时在浏览器里右键元素 → 检查就能在开发者工具里看到它的各种属性这比盲写选择器靠谱得多。7.2 等一下 vs 等到元素出现新手阶段容易一律用time.sleep等 3 秒、等 5 秒凑合能跑。但网络一慢等 5 秒不够网络快的时候白等 5 秒。更好的做法是显式等待也就是“等到某个条件满足为止”。Selenium 提供了 WebDriverWaitfrom selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC wait WebDriverWait(driver, 10) search_box wait.until(EC.presence_of_element_located((By.ID, search-input))) search_box.send_keys(自动化)这段代码的意思是最多等 10 秒直到页面上出现 id 为 search-input 的元素再继续执行。如果 10 秒内没出现抛 TimeoutException。这个“等待 条件”的组合才是 Selenium 稳定性的正确打开方式。元素出现得快就立刻执行出现得慢就多等不会因为固定睡眠时间导致脚本时灵时不灵。7.3 我的实操体会整套环境配置走到这里核心其实就是三件事版本匹配、路径正确、解释器一致。想明白这三点后面遇到的 90% 环境问题都能自己定位。剩下那 10%大部分是网络环境、杀毒软件、浏览器自动更新这些外部因素也都有套路可循。第一次跑通脚本后别急着去啃大而全的框架。先写几个小任务练手自动打开某个网页抓取标题、自动登录一个测试站点、批量把搜索结果收集到一个列表。这些基础动作练熟后再去接触 pytest、unittest 这些测试框架你会发现它们的本质都是给这些基础操作穿上管理的外衣。最后再分享一个小技巧。很多人在项目里写了不止一个自动化脚本每次运行都现写 Service 和显式路径啰嗦又容易出错。你可以把驱动初始化封装成一个函数放在一个公共模块里所有脚本直接复用from selenium import webdriver from selenium.webdriver.chrome.service import Service def init_driver(): service Service(rD:\tools\chromedriver.exe) options webdriver.ChromeOptions() options.add_experimental_option(detach, True) # 手动关闭后浏览器不退出看代码时更省事 return webdriver.Chrome(serviceservice, optionsoptions)以后每个脚本开头只要写一句driver init_driver()干净利落。当然这只是工程化思维的第一步等你写了几百行脚本自然会对代码组织有自己的想法。自动化这条路上坑不会断但每填平一个你对浏览器工作机制的理解就更深一层。 
长河君 · 2026/10/10 21:22:33 · 阅读 1.2k Selenium 自动化环境配置指南：从 Python 安装到跑通第一个脚本
“你装三遍还是报错不是因为笨而是每一步踩的坑没人提前告诉你。”很多刚开始学自动化的人第一步都栽在同一件事上照着网上的教程装 PyCharm、Python、Selenium装完一运行满屏红字。模块明明装过却说找不到驱动也下了但版本对不上好不容易跑起来又卡在“找不到元素”。我把从空白环境到跑通第一个自动化脚本的完整过程包含我自己踩过的每一个坑整理成这份实操教程。核心就一件事让你花一个下午就能跑通而不是一个周末。全文按安装顺序展开从 Python 版本选择、PyCharm 解释器配置到 Selenium 安装、浏览器驱动版本匹配再到第一个脚本逐行拆解最后是一些高频报错的排查速查。零基础直接照做已经装过但被各种报错劝退的也可以按章节对照排查。1. 这套组合的关系与整体安装顺序1.1 Python、PyCharm、Selenium 各自扮演什么角色先花几分钟把这三个东西的关系搞清楚后面排错会省一大半力气。很多新手一报错就以为 Selenium 没装好其实八成是 Python 环境乱了或者 PyCharm 选错了解释器。Python 是根本。它是一门编程语言你写的自动化脚本本质上就是一段 Python 代码。没有 Python后面两个都无从谈起。PyCharm 是一个编辑器准确说是集成开发环境。它让你写代码更舒服有语法高亮、代码补全、断点调试。它的存在是“提升效率”不是“必需”。你不装 PyCharm用记事本写代码然后在命令行执行理论上也能跑通自动化。但对新手来说PyCharm 的断点调试比到处打印日志友好太多了。我建议老老实实装上。Selenium 是自动化库。它不是一个独立软件而是 Python 的一个第三方库用 pip 安装。它的作用很简单让你用代码控制真实的浏览器去打开网页、点击按钮、填写表单、抓取数据。打个比方Python 是发动机PyCharm 是修车车间Selenium 是机械手臂。发动机提供动力车间方便你操作机械手臂帮你实际动手。你问“我只想要机械手臂行不行”不行因为手臂要靠发动机驱动车间让你看得清手在哪儿、出了什么问题。1.2 Selenium 的工作原理一条链路看懂它Selenium 能控制浏览器靠的可不是魔法。它自己不会打开任何窗口真正打开浏览器的是驱动对 Chrome 来说就是 chromedriverChromeDriver。完整链路是这样的你的脚本 → Selenium 库 → chromedriver.exe → Chrome 浏览器 → 网页每一层都有明确分工。脚本里写的driver.get(某个网址)会被 Selenium 翻译成一条控制命令交给 chromedriverchromedriver 再用 Chrome 支持的调试协议让浏览器真的去访问这个网址。这条链路理解了排错逻辑就清楚了报错发生在哪一段问题就出在哪一段。比如报错说“chromedriver 需要放到 PATH 里”那是链路的第二段断了报错说“ChromeDriver 只支持 Chrome 某个版本”那是驱动和浏览器之间没对上。这也是为什么我强调按顺序安装。很多人先装好了 Chrome 和 PyCharm再回头补 Python最后装 Selenium 的时候已经不知道自己的环境乱成什么样了一报错根本无从查起。按顺序来每一步验证完再走下一步出问题就能快速定位。1.3 推荐的安装顺序与验证节奏我的建议顺序安装 Python 并验证版本安装 PyCharm 并新建项目、确认解释器在项目终端里用 pip 安装 Selenium配置浏览器驱动写一个最小脚本跑通每一步都要做“验证”再往下走。什么是验证装完 Python 后在命令行输入python --version看到版本号输出才算过关。装完 Selenium在终端里执行pip show selenium确认包存在才算过关。别急着一次性装完所有东西再开跑那样一旦报错你根本不知道是哪一个环节出了问题。我自己第一遍就是这个心态结果最后报错的时候花了三个小时逐个排除才意识到是最开始 Python 的 PATH 没勾上。如果当时每步都验证这个坑三分钟就能发现。2. Python 安装新手第一道坎2.1 版本选择与下载方式去 Python 官方网站下载 Windows 安装包选 64 位的版本。现在绝大多数电脑都是 64 位系统除非你的机器特别老否则不要选 32 位。版本怎么选我建议用 Python 3.11 或 3.12都是成熟稳定的版本。不要盲目追新太新的版本可能出现个别第三方库还没适配的情况也不要选太老的版本比如 3.8 以下Selenium 新版本对这类老环境的兼容性已经逐渐放弃了。这里有个细节Selenium 4.x 系列对 Python 版本要求不算苛刻但你后面可能还要装 pandas、requests 等其他库这些库对新版本的跟进速度有差异。选一个“生态普遍支持”的版本而不是“最新”的版本是更稳妥的思路。目前 3.12 是多数库已经完成适配的选择我实际跑下来没什么兼容性问题。下载时注意文件名里的Windows installer (64-bit)不要下成源码包。下载完成后直接双击运行进入安装向导。2.2 安装时必勾的 PATH 选项进入安装界面时第一屏最下面有一个复选框“Add python.exe to PATH”。这个必须勾这是新手踩得最多的坑没有之一。PATH 是什么你可以把它理解成一个“快捷方式目录”。系统在命令行里输入python时会按 PATH 里记录的文件夹一个个去找有没有叫 python 的程序。你不勾选就是把 python.exe 藏在一个系统不知道的角落里之后输入python就会提示“不是内部或外部命令”。如果你能自定义安装路径建议选一个简单的目录比如D:\Python312尽量避免带空格或中文的路径。虽然官方默认路径也能用但默认位置藏在用户目录下之后你找文件、配驱动的时候会多绕一些路。放到一个你记得住的简单目录后面排查问题方便很多。勾上 PATH 之后直接点 Install Now网速和硬盘都够的话一两分钟就能装完。2.3 怎么确认 Python 真的装好了安装完成后按Win R输入cmd回车打开命令行窗口依次输入两条命令python --version pip --version如果分别输出了类似Python 3.12.x和pip 24.x的版本信息说明安装成功。万一提示找不到命令第一反应先检查是不是 PATH 没勾上。重新打开安装程序选择 Modify把 “Add python.exe to PATH” 补勾上就行。另外可以执行where python这条命令会列出系统能找到的所有 python 路径。这个命令在排查“装了两个 Python”时特别有用。你可能会看到两条路径一条是你装的另一条可能是某些软件自带的。后面 PyCharm 选解释器的时候要小心选到你真正想要的那个。这里要专门提醒一个特别容易误导新手的概念命令行里的 python 和 PyCharm 里的 python不一定是同一个。后面 Selenium “找不到模块”的报错很多都是因为这个错位。所以每新建一个项目都要确认 PyCharm 到底用的是哪个解释器。3. PyCharm 安装与项目解释器配置3.1 用哪个版本社区版足够吗PyCharm 有两个版本社区版Community和专业版Professional。社区版是免费的专业版收费有 30 天试用。做 Selenium 自动化社区版完全够用。注意我的措辞是“完全够用”不是“勉强能用”。项目创建、代码编辑、终端运行、断点调试这些核心功能社区版都有。专业版多的主要是 Web 开发框架支持、远程部署、数据库工具这些跟入门自动化基本没关系。别一开始就为IDE花钱先把自动化跑起来再说。从官网下载社区版安装包装的时候一路默认就行。首次启动会让你选主题配色选个顺眼的然后进到欢迎界面点击 New Project 新建项目。3.2 新建项目时的关键选择新建项目界面里最重要的一个区域是 “New environment using” 或者叫 “Project Interpreter”。对新手来说这里默认的选项基本不用动但要理解它在干什么。它的实质是告诉 PyCharm接下来用哪一个 Python 程序来执行你的代码。这个选择决定了三件事代码运行时用哪个 Python、pip 安装的包装到哪里、import 的时候从哪些目录找库。任何一个错了都会出现“模块找不到”的诡异问题。默认情况下PyCharm 会基于你安装好的那个 Python 版本自动创建一个 venv 虚拟环境。如果你的机器上只有刚才装的一个 Python那这里显示的就是Python 3.12直接认可即可。我见过很多新手在这个界面反复纠结甚至手动去选别的路径结果选了一个别的软件自带的 Python后续各种诡异报错。最好的做法是保持默认确保它显示的是你刚装的那个版本。如果你装了多个 Python下拉开菜单确认选到正确的那一个。3.3 虚拟环境 venv 到底是个什么东西venv 是 Python 自带的一个工具中文叫虚拟环境。它的作用是给每个项目开一个独立的“小房间”房间里有一套自己的 Python 解释器和自己的包仓库。为什么需要它因为不同项目可能依赖不同版本的库。A 项目需要 Selenium 4.6B 项目可能因为老代码只能用 Selenium 3.14。如果都装到全局环境就会互相打架。有了虚拟环境各用各的互不干扰。PyCharm 新建项目时会自动在项目目录下生成一个venv文件夹。所以你不需要手动创建任何环境但你要知道这个文件夹是干什么的。你通过 PyCharm 终端执行pip install selenium时装进去的位置就是这个 venv 文件夹里的 site-packages 目录而不是你计算机的全局环境。什么时候会出问题当你在“系统命令行”里执行pip install selenium而 PyCharm 项目用的是 venv那你装的包和项目用的环境就不是同一个。你说“我明明装了”但代码一运行还是ModuleNotFoundError。解决办法很简单所有安装操作一律在 PyCharm 底部自带的 Terminal 窗口里执行。这个窗口默认就激活了当前项目的虚拟环境装的包绝对没错。4. Selenium 安装与浏览器驱动的版本陷阱4.1 装 Selenium必须在 PyCharm 的终端里执行Selenium 的安装命令就一行pip install selenium但执行它的位置决定了你成不成功。一定在 PyCharm 底部的 Terminal 里执行。PyCharm 创建项目后左下角或底部有一个 “Terminal” 标签点开就是命令行界面。那个界面已经自动进入了当前项目的虚拟环境在这里执行 pip install装的东西百分之百归这个项目用。如果你嫌默认源下载慢国内网络环境下经常卡在等待下载可以临时加镜像源参数pip install selenium -i https://镜像站地址/simple更省事的做法是给 pip 配一个默认的国内镜像源这样以后装任何包都不用每次带参数。具体做法是在用户目录下新建一个 pip 配置文件写入镜像地址。镜像站地址网上搜“pip 国内镜像”选个稳定的用就行。这是常规提速操作不是绕路就是换一个离你更近的下载源。装完之后在终端里执行pip show selenium能看到版本信息和安装位置就说明进入到这个项目的环境里了。也可以跑一句python -c import selenium; print(selenium.__version__)能打印出版本号就是真正可用的状态。4.2 ChromeDriver 为什么老是对不上版本安装完 Selenium脚本还跑不起来因为 Selenium 本身不含浏览器。它只负责发指令真正执行指令的是浏览器驱动。以 Chrome 浏览器为例这个驱动叫 chromedriver或 ChromeDriver。版本匹配是整个 Selenium 配置里最大的一个坑ChromeDriver 的版本必须和 Chrome 浏览器的版本对应上。主版本号不一致就会直接报错。Chrome 有个臭名昭著的特性默认自动更新。你晚上睡觉的时候Chrome 悄悄从 121 升到了 122第二天你打开脚本之前能跑的驱动立刻失配。这是无数人反复踩坑的根源。怎么查版本打开 Chrome点右上角三个点 → 帮助 → 关于 Google Chrome弹出的页面里会显示版本号比如122.0.xxxx.xx。你要下载的 chromedriver 主版本号也必须是 122 开头的小版本号通常对应关系没那么严格主版本对上了基本就能用。下载 chromedriver 有两条正常渠道一个是 Chrome for Testing 的官方下载页它会列出各版本对应的驱动另一个是各类国内镜像站下载速度快一些。下载下来的是一个压缩包解压后得到chromedriver.exe就这么一个文件。4.3 让 webdriver-manager 帮你管理驱动手动管理驱动太痛苦了浏览器一自动升级就失配。我强烈建议新手直接用webdriver-manager这个库它能自动检测你本机 Chrome 的版本然后去匹配的地址下载对应驱动并缓存到本地以后再也不用手动管版本。安装pip install webdriver-manager代码里这么写from selenium import webdriver from selenium.webdriver.chrome.service import Service from webdriver_manager.chrome import ChromeDriverManager service Service(ChromeDriverManager().install()) driver webdriver.Chrome(serviceservice)第一次运行时它会检测 Chrome 版本、下载对应的 chromedriver 并缓存可能需要十几秒。之后再运行直接使用缓存的驱动基本毫秒级启动。实测下来非常稳这是我踩完版本匹配的坑之后一直在用的方案。有人可能会问这不又多了一个依赖吗是的但带来的好处是彻底摆脱手动维护驱动的噩梦对新手来说这个权衡非常划算。等以后你熟练了知道怎么手动管版本再根据自己的场景选方案不迟。4.4 驱动路径的三种接法如果你还是想手动管理 chromedriver驱动路径有三种常见的接法。第一种把chromedriver.exe放到和你的脚本同一个目录然后直接写driver webdriver.Chrome()。Selenium 会按默认规则在当前目录找。但我得说实话这个方式在你的编辑器“运行目录”和脚本目录不一致时经常莫名其妙找不到不建议新手用。第二种显式指定驱动路径这是我最推荐的方式。代码里指定Serviceservice Service(rD:\tools\chromedriver.exe) driver webdriver.Chrome(serviceservice)Windows 路径里的反斜杠是转义符所以要么用原生字符串r...要么写成双反斜杠D:\\tools\\chromedriver.exe。新手最容易在这里踩坑路径写对了但忘了解压驱动或者解压后文件名其实叫chromedriver.exe但你写成了chromedriver。用绝对路径最清晰报错去看也知道该检查哪里。第三种把驱动所在目录加进系统 PATH 环境变量。文件资源管理器 → 右键此电脑 → 属性 → 高级系统设置 → 环境变量 → 在 Path 里新建一行把chromedriver.exe所在文件夹的路径填进去。配完之后代码里可以直接webdriver.Chrome()不用指定路径。这种做法适合你以后要写很多脚本、不想每个都写路径的场景。但对新手来说修改系统级 PATH 有一定风险改错了可能影响别的软件所以我一般建议先用显式路径以后再考虑。5. 第一个自动化脚本从空文件到跑通5.1 新建项目和 Python 文件到这一步环境的基础配置已经完成。打开 PyCharm点击 New ProjectLocation 填你的项目路径例如D:\my_selenium_demoEnvironment 保持默认的 venvCreate 创建项目。项目创建后在左侧项目目录上右键 → New → Python File输入文件名demo回车。PyCharm 会自动帮你创建一个demo.py文件后缀不用手动加。5.2 脚本代码逐行拆解第一个脚本别贪多目标就是“打开一个浏览器访问一个网页停两秒关闭”。把这段代码复制进去from selenium import webdriver from selenium.webdriver.chrome.service import Service import time # 指定 chromedriver 的路径换成你自己的实际路径 service Service(rD:\tools\chromedriver.exe) # 启动浏览器会弹出一个真实的 Chrome 窗口 driver webdriver.Chrome(serviceservice) # 访问一个示例网站 driver.get(https://example.com) # 等 2 秒让页面载荷完成也方便你观察浏览器状态 time.sleep(2) # 关闭浏览器并退出驱动进程 driver.quit()逐行解释一下你以后写任何 Selenium 脚本开头都是这几行。from selenium import webdriver导入 Selenium 的核心模块之后所有浏览器操作都挂在 webdriver 这个命名空间下。from selenium.webdriver.chrome.service import Service导入驱动管理类它负责把 chromedriver 启动起来并和浏览器建立连接。import time是 Python 自带的时间模块这里只用到 sleep 暂停功能。service Service(rD:\tools\chromedriver.exe)就是前面说的显式指定驱动路径。注意这里的路径必须是你机器上实际保存 chromedriver.exe 的位置不要照抄我的。driver webdriver.Chrome(serviceservice)创建 WebDriver 对象。这行一执行你的屏幕上就会弹出一个新的 Chrome 窗口窗口顶部会有一行提示“Chrome 正受到自动测试软件的控制”这是正常现象。driver.get(https://example.com)让浏览器访问这个网址。example.com 是专门用来测试的示例域名不会因为脚本访问产生安全问题。time.sleep(2)让程序暂停两秒。新手阶段先用这种简单粗暴的等待方式后面讲到显式等待你会明白更好的做法但第一步不必那么讲究。driver.quit()关闭浏览器并结束驱动进程。这行非常重要。只关窗口而省略这行会导致后台残留 chromedriver 进程累积多了会占用系统资源。5.3 运行、调试与收尾在 PyCharm 里右键demo.py文件选择Run demo。底部会打开 Run 窗口你会看到 Chrome 窗口弹出、访问地址、停留两秒然后自己关闭。整个过程没有红色报错恭喜你的第一个自动化脚本跑通了。如果运行环境里有杀毒软件拦截 chromedriver你可能会看到弹窗需要选择允许。这是个容易被忽略的外部坑。你如果想亲眼看看操作过程可以把time.sleep(2)改成time.sleep(10)或者运行过程中不要手动去关浏览器窗口让脚本自己走完。跑通这个最简脚本后再试着加一点交互逻辑比如搜索关键词。假设页面上有一个输入框 id 是search-input一个按钮 id 是search-btn代码可以这样from selenium.webdriver.common.by import By driver.find_element(By.ID, search-input).send_keys(自动化) driver.find_element(By.ID, search-btn).click() time.sleep(3) driver.quit()这里第一次接触到find_element它是定位页面元素的入口。By.ID表示按元素 id 查找。这是 Selenium 最常用的操作之一后面你会反复用到。调试方面建议早点学会断点调试。在行号右侧点一下会出现一个红点这就是断点。然后点击右上角的 Debug 图标长得像一只虫子运行程序执行到断点那一行就会暂停。你可以高亮悬停变量查看值也可以点“Step Over”单步执行。这比到处写 print 观察变量高效得多。6. 高频报错排查实录6.1 报错信息速查表我把运行 Selenium 脚本最常见的报错整理成一张速查表你遇到问题先对照它大多数情况能直接解决。报错信息片段真正原因解决办法ModuleNotFoundError: No module named seleniumSelenium 没装进当前项目环境或解释器指向错误在 PyCharm 的 Terminal 里执行 pip install selenium检查右下角解释器路径chromedriver executable needs to be in PATH找不到 chromedriver 程序用 Service 显式指定 chromedriver.exe 的绝对路径This version of ChromeDriver only supports Chrome version xx驱动和 Chrome 版本不匹配改用 webdriver-manager 自动匹配或手动下载对应版本[WinError 2] 系统找不到指定的文件驱动路径写错、路径不存在或驱动没解压检查 Service 里的路径是否真实存在确认压缩包已解压NoSuchElementException页面没有你要找的元素或元素还没加载出来检查元素的 id/class 是否写对改用显式等待TimeoutException等待超时元素一直没有出现检查选择器准确性确认页面是否真的包含该元素控制台中文乱码终端编码和脚本编码不一致把 PyCharm 文件编码和终端编码都统一为 UTF-86.2 几个容易误判的排查细节ModuleNotFoundError是最容易误判的。新手会说“我明明装了 Selenium”。这时候先别怀疑 pip 装错了十有八九是解释器的问题。看 PyCharm 右下角如果没有显示 Python 版本号说明还没有设置解释器。操作路径是File → Settings → Project → Python Interpreter把解释器切换到venv里那个 3.12。切换后重启终端再在 Terminal 里pip list看一下有没有 selenium往往就豁然开朗了。还有一个典型的误判是报错只提到chromedriver却在催你配环境变量。其实问题不一定在 PATH而是你的驱动文件根本没放在正确的位置或者路径写错了。显式指定绝对路径能绕开这个排查过程也是我推荐新手用 Service 的原因。SessionNotCreatedException这种带版本号的报错处理逻辑很清晰打开 Chrome 的“关于”页看主版本号再看 chromedriver 的主版本号要么升级驱动要么用 webdriver-manager 自动解决。不要试图去改脚本绕过版本匹配是硬性要求绕不过去。另外注意一个很容易忽略的事脚本跑完以后如果任务管理器里能看到很多残留的 chrome.exe 或 chromedriver.exe 进程说明你的driver.quit()没有在某些异常情况下执行到。写成下面的形式更稳妥try: driver webdriver.Chrome(serviceservice) driver.get(https://example.com) time.sleep(2) finally: driver.quit()finally里的代码无论前面是否报错都会执行这样即使脚本中途异常浏览器也能被正常关闭不会留下僵尸进程。7. 跑通之后几个值得早点知道的事7.1 元素定位的优先级跑通基础脚本后自动化真正的工作量在于精确定位页面元素。定位的方式有很多种但它们之间有优先级。记住这个顺序优先By.ID这是页面设计上理应唯一的属性没有 id 时用By.NAME再不行用By.CSS_SELECTOR最后才用By.XPATH。新手最容易犯的错误是一上来就用 XPath而且是浏览器开发者工具里右键“复制完整 XPath”得到的绝对路径。这种路径长得像html/body/div[2]/form/input[1]页面任何结构调整都会让它失效。我建议你学会写相对路径比如driver.find_element(By.XPATH, //input[placeholder请输入搜索内容])这行代码的意思是查找 page 上任意位置、标签为 input、且 placeholder 属性等于指定内容的那一个元素。比绝对路径健壮得多。实在不确定元素长什么样时在浏览器里右键元素 → 检查就能在开发者工具里看到它的各种属性这比盲写选择器靠谱得多。7.2 等一下 vs 等到元素出现新手阶段容易一律用time.sleep等 3 秒、等 5 秒凑合能跑。但网络一慢等 5 秒不够网络快的时候白等 5 秒。更好的做法是显式等待也就是“等到某个条件满足为止”。Selenium 提供了 WebDriverWaitfrom selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC wait WebDriverWait(driver, 10) search_box wait.until(EC.presence_of_element_located((By.ID, search-input))) search_box.send_keys(自动化)这段代码的意思是最多等 10 秒直到页面上出现 id 为 search-input 的元素再继续执行。如果 10 秒内没出现抛 TimeoutException。这个“等待 条件”的组合才是 Selenium 稳定性的正确打开方式。元素出现得快就立刻执行出现得慢就多等不会因为固定睡眠时间导致脚本时灵时不灵。7.3 我的实操体会整套环境配置走到这里核心其实就是三件事版本匹配、路径正确、解释器一致。想明白这三点后面遇到的 90% 环境问题都能自己定位。剩下那 10%大部分是网络环境、杀毒软件、浏览器自动更新这些外部因素也都有套路可循。第一次跑通脚本后别急着去啃大而全的框架。先写几个小任务练手自动打开某个网页抓取标题、自动登录一个测试站点、批量把搜索结果收集到一个列表。这些基础动作练熟后再去接触 pytest、unittest 这些测试框架你会发现它们的本质都是给这些基础操作穿上管理的外衣。最后再分享一个小技巧。很多人在项目里写了不止一个自动化脚本每次运行都现写 Service 和显式路径啰嗦又容易出错。你可以把驱动初始化封装成一个函数放在一个公共模块里所有脚本直接复用from selenium import webdriver from selenium.webdriver.chrome.service import Service def init_driver(): service Service(rD:\tools\chromedriver.exe) options webdriver.ChromeOptions() options.add_experimental_option(detach, True) # 手动关闭后浏览器不退出看代码时更省事 return webdriver.Chrome(serviceservice, optionsoptions)以后每个脚本开头只要写一句driver init_driver()干净利落。当然这只是工程化思维的第一步等你写了几百行脚本自然会对代码组织有自己的想法。自动化这条路上坑不会断但每填平一个你对浏览器工作机制的理解就更深一层。