Python Selenium脚本打包成EXE：PyInstaller与WebDriver-Manager实战指南

1. 项目概述与核心价值

最近在跟几个做测试和运营的朋友聊天，他们都在用 Python 的 Selenium 写一些自动化脚本，比如定时签到、数据抓取、网页巡检之类的。脚本写好了，在自己电脑上跑得挺欢，但一到要分发给同事或者部署到没有 Python 环境的服务器上，问题就来了：要么对方不会装 Python，要么环境依赖乱七八糟，一个脚本传过去，附带的安装说明比脚本本身还长。这让我想起了自己刚入行时踩过的坑，所以今天想系统地聊聊，怎么把一个依赖 Selenium 的 Python 脚本，干净利落地打包成一个独立的.exe可执行文件，真正做到“一次打包，随处运行”。

这个需求的核心价值在于降低使用门槛和提升部署效率。想象一下，你写了一个自动填写日报的脚本，想分享给团队里不懂技术的同事。如果直接给.py文件，他得先装 Python，再装 selenium、webdriver-manager 等一堆库，版本不对还可能报错，整个过程足以劝退任何人。但如果你给的是一个双击就能运行的.exe文件，事情就简单多了。这对于测试人员分发自动化测试用例、开发者交付给客户的小工具、或者运维人员部署定时任务脚本，都是非常实用的技能。打包不是简单的“封装”，它涉及到依赖管理、路径处理、浏览器驱动兼容性等一系列细节，把这些细节处理好，你的脚本才能真正具备产品级的交付能力。

2. 打包方案选型与工具链解析

当我们决定要把 Python 脚本打包成 exe 时，市面上有几个主流选择：PyInstaller、cx_Freeze、Py2exe、Nuitka 等。经过多年的实践和对比，我强烈推荐 PyInstaller，这也是社区里绝大多数人的选择。为什么是它？首先，PyInstaller 对 Windows 的支持最为成熟和稳定，这是我们的目标平台。其次，它支持“单文件模式”（-F 参数），能把所有依赖（包括 Python 解释器本身）打包进一个 exe，分发极其方便。最后，它的社区活跃，遇到问题容易找到解决方案，而且对像 Selenium 这样涉及外部进程（浏览器）和动态库的复杂场景，处理经验也更丰富。

不过，光有 PyInstaller 还不够。一个典型的 Selenium 自动化脚本的打包工具链，通常包含以下几个核心组件：

1. PyInstaller: 打包主引擎，负责收集脚本、解释器、依赖库并生成可执行文件。
2. WebDriver 管理器 (如webdriver-manager): 这是解决浏览器驱动兼容性的“神器”。传统做法需要手动下载匹配浏览器版本的 chromedriver.exe 并放在指定路径，而webdriver-manager可以在运行时自动检测系统已安装的浏览器版本，并下载对应的驱动，极大简化了部署。
3. 虚拟环境 (如venv或conda): 强烈建议在干净的虚拟环境中进行打包操作。这能确保打包时捕获的依赖是你项目真实需要的，避免把全局 Python 环境里一堆无关的库也打进去，导致 exe 文件体积臃肿，甚至引入冲突。

这里有一个关键决策点：是否将浏览器驱动打包进 exe？早期的方案，就像参考文章里提到的，需要手动将chromedriver.exe复制到与打包出的 exe 同级目录。这种方法简单，但不够优雅，且无法应对用户电脑浏览器版本升级的情况。更现代、更推荐的做法是集成webdriver-manager。它的原理是，当你的脚本启动时，webdriver-manager会检查本地缓存中是否有匹配当前浏览器版本的驱动，如果没有，则从官方源下载。这样，你的 exe 就具备了“自适应”能力，无需随浏览器升级而重新打包。

注意：使用webdriver-manager意味着打包后的 exe 在首次运行时可能需要联网下载驱动。如果你的使用场景是绝对离线的内网环境，则需要采用“离线包”模式，即提前下载好特定版本的驱动，并将其作为数据文件打包进 exe，然后在代码中指定其路径。这稍微复杂一些，但 PyInstaller 的--add-data参数可以支持。

3. 环境准备与项目结构优化

在动手打包之前，我们先花点时间把环境和项目结构整理好。一个清晰的结构是成功打包的一半。

3.1 创建并激活虚拟环境

打开命令行（CMD 或 PowerShell），为你的项目创建一个独立的虚拟环境。

# 进入你的项目目录 cd D:\my_selenium_project # 创建虚拟环境，环境文件夹名为 `venv` python -m venv venv # 激活虚拟环境 (Windows) venv\Scripts\activate

激活后，命令行提示符前通常会显示(venv)，表示你已进入该虚拟环境。之后所有pip install操作都只影响这个环境。

3.2 安装项目依赖

在虚拟环境中，安装你的脚本所需的库。一个典型的依赖列表如下：

pip install selenium pip install webdriver-manager # 安装打包工具 PyInstaller pip install pyinstaller

3.3 优化脚本代码以适应打包

参考文章中的示例脚本直接使用了executable_path来指定驱动，这在打包场景下是不灵活的。我们来重写一个更健壮、更适合打包的run.py：

# run.py import time from selenium import webdriver from selenium.webdriver.chrome.service import Service from webdriver_manager.chrome import ChromeDriverManager from selenium.webdriver.chrome.options import Options def main(): # 1. 设置 Chrome 选项（可选） chrome_options = Options() # 无头模式（不显示浏览器界面），适用于服务器环境 # chrome_options.add_argument('--headless') # 禁用GPU加速，避免某些环境下的问题 chrome_options.add_argument('--disable-gpu') # 禁用沙箱，在某些Windows配置下可能需要 chrome_options.add_argument('--no-sandbox') # 单进程模式，提高稳定性 chrome_options.add_argument('--single-process') # 2. 使用 webdriver-manager 自动管理驱动 # Service 对象用于指定驱动路径，ChromeDriverManager().install() 会自动处理下载和路径 service = Service(ChromeDriverManager().install()) # 3. 初始化浏览器驱动 # 注意：这里不再需要指定 executable_path driver = webdriver.Chrome(service=service, options=chrome_options) try: # 你的自动化逻辑 driver.get("https://www.baidu.com") print(f"页面标题是：{driver.title}") time.sleep(5) # 等待5秒，便于观察 except Exception as e: print(f"运行过程中出现错误：{e}") finally: # 确保浏览器被关闭 driver.quit() if __name__ == "__main__": main()

这段代码的关键改进在于使用了webdriver_manager和Service对象。ChromeDriverManager().install()这个调用会在后台自动完成驱动的查找、下载（如果需要）和路径返回，完美解决了驱动与浏览器版本的匹配问题，让我们的 exe 具备了跨环境运行的能力。

3.4 测试脚本在开发环境下的运行

在打包前，务必先在当前的虚拟环境中运行一下python run.py，确保脚本本身能正常工作。这是最基本的调试步骤，能排除代码语法错误和基础依赖问题。

4. 使用 PyInstaller 进行打包与深度配置

环境准备好，代码也优化了，现在进入核心的打包环节。PyInstaller 的命令行参数很多，我们针对 Selenium 项目来详细拆解几个关键参数。

4.1 基础打包命令

最基础的打包命令是生成一个单文件夹（包含 exe 和所有依赖的 DLL、库文件）：

pyinstaller run.py

这会在项目目录下生成build和dist两个文件夹。dist/run文件夹里就是打包好的内容，其中run.exe是主程序。这种方式依赖文件散落在文件夹中，适合调试，但分发需要压缩整个文件夹。

4.2 生成单文件 exe（推荐）

我们更希望分发一个单独的文件，使用-F(或--onefile) 参数：

pyinstaller -F run.py

这会生成dist/run.exe这一个文件。所有依赖都被压缩包裹在这个 exe 内部。运行时，exe 会先将自己解压到一个临时目录（如C:\Users\用户名\AppData\Local\Temp\_MEIxxxxx），然后从那里执行。执行完毕后，临时文件通常会被清理。

4.3 添加图标和版本信息

为了让你的 exe 看起来更专业，可以添加自定义图标和版本信息。

• 添加图标 (-i): 准备一个.ico格式的图标文件（可以用在线工具将 png 转 ico）。

  pyinstaller -F -i my_icon.ico run.py

• 添加版本信息 (--version-file): 创建一个.txt文件（如version_info.txt），内容如下：

  # UTF-8 VSVersionInfo( ffi=FixedFileInfo( filevers=(1, 0, 0, 0), prodvers=(1, 0, 0, 0), mask=0x3f, flags=0x0, OS=0x40004, fileType=0x1, subtype=0x0, date=(0, 0) ), kids=[ StringFileInfo( [ StringTable( u'040904B0', [StringStruct(u'CompanyName', u'我的公司'), StringStruct(u'FileDescription', u'Selenium自动化工具'), StringStruct(u'FileVersion', u'1.0.0.0'), StringStruct(u'InternalName', u'run'), StringStruct(u'LegalCopyright', u'Copyright © 2023'), StringStruct(u'OriginalFilename', u'run.exe'), StringStruct(u'ProductName', u'自动化工具'), StringStruct(u'ProductVersion', u'1.0.0.0')]) ] ), VarFileInfo([VarStruct(u'Translation', [1033, 1200])]) ] )

  然后在打包命令中引用它：

  pyinstaller -F --version-file=version_info.txt run.py

4.4 处理隐藏导入和排除模块

PyInstaller 通过静态分析你的脚本来收集依赖。但有些库（特别是动态导入的）它可能发现不了，导致打包后运行报ModuleNotFoundError。Selenium 本身通常没问题，但如果你用了其他一些辅助库，可能需要手动指定。

• 隐藏导入 (--hidden-import): 例如，如果你使用了pandas，而 PyInstaller 没分析到，可以这样添加：

  pyinstaller -F --hidden-import=pandas run.py

  对于 Selenium，一般不需要，但如果你遇到相关错误，可以尝试--hidden-import=selenium.webdriver.common.by。

• 排除模块 (--exclude-module): 为了减小 exe 体积，可以排除一些确定用不到的模块。比如，你的脚本只用了 Chrome，可以尝试排除其他浏览器的驱动模块（但需谨慎）：

  pyinstaller -F --exclude-module selenium.webdriver.firefox --exclude-module selenium.webdriver.edge run.py

4.5 针对 Selenium 的特殊配置：数据文件与路径问题

这是打包 Selenium 项目最容易出错的地方。webdriver-manager在运行时需要访问其内部的配置文件（如drivers.json）来查询驱动版本信息。这些文件在 PyInstaller 打包后，默认不在标准模块搜索路径里。

解决方法是将webdriver-manager的包数据文件作为“数据文件”添加到打包中。我们需要找到webdriver-manager安装后，其包含数据文件的目录。一个通用的方法是使用sys._MEIPASS。

首先，创建一个打包规范文件run.spec。你可以通过运行一次pyinstaller run.py生成一个基础的 spec 文件，然后编辑它。或者，更直接地在命令行中处理：

pyinstaller -F ^ --add-data "%VIRTUAL_ENV%\Lib\site-packages\webdriver_manager;webdriver_manager" ^ run.py

这条命令做了两件事：

1. --add-data: 将虚拟环境中webdriver_manager包的整个文件夹，在打包时复制到 exe 内部的相对路径webdriver_manager下。
2. %VIRTUAL_ENV%是环境变量，指向你的虚拟环境目录。在 PowerShell 中可以用$env:VIRTUAL_ENV。

但是，这还不够。我们需要修改run.py，让webdriver-manager知道去哪里找这些数据文件。修改后的脚本开头部分如下：

# run.py import sys import os import time from selenium import webdriver from selenium.webdriver.chrome.service import Service from webdriver_manager.chrome import ChromeDriverManager from selenium.webdriver.chrome.options import Options # PyInstaller 打包后，会设置 sys._MEIPASS 属性指向临时解压目录 def resource_path(relative_path): """ 获取打包后资源的绝对路径 """ try: # PyInstaller 创建的临时文件夹路径 base_path = sys._MEIPASS except AttributeError: # 正常开发环境下的路径 base_path = os.path.abspath(".") return os.path.join(base_path, relative_path) def main(): chrome_options = Options() # ... 你的 chrome_options 配置 ... # 关键步骤：设置 webdriver-manager 的数据文件路径 # 方法1：设置环境变量（推荐，对 webdriver-manager 透明） if hasattr(sys, '_MEIPASS'): os.environ['WDM_LOCAL'] = '1' # 可选，优先使用本地缓存 # 将 webdriver_manager 的包数据路径添加到环境变量中 driver_manager_path = resource_path('webdriver_manager') os.environ['WDM_PATH'] = driver_manager_path # 方法2：直接指定驱动缓存路径（更直接） # from webdriver_manager.core.download_manager import WDMDownloadManager # from webdriver_manager.core.manager import DriverManager # 这种方式更底层，需要更复杂的代码来接管驱动管理流程。 # 对于大多数情况，方法1（环境变量）结合正确的 --add-data 已经足够。 service = Service(ChromeDriverManager().install()) driver = webdriver.Chrome(service=service, options=chrome_options) try: driver.get("https://www.baidu.com") print(f"页面标题是：{driver.title}") time.sleep(5) except Exception as e: print(f"运行过程中出现错误：{e}") finally: driver.quit() if __name__ == "__main__": main()

4.6 最终打包命令整合

综合以上所有考量，一个比较完善的打包命令可能长这样（在项目根目录下执行）：

# 在激活的虚拟环境中执行 pyinstaller -F ^ -i my_app_icon.ico ^ --add-data "%VIRTUAL_ENV%\Lib\site-packages\webdriver_manager;webdriver_manager" ^ --hidden-import=pkg_resources.py2_warn ^ # 有时需要，解决 pkg_resources 相关警告 --clean ^ # 清理之前的打包缓存 run.py

执行这个命令后，PyInstaller 会开始分析、收集、打包。过程可能会持续几十秒到几分钟，取决于项目复杂度。完成后，你会在dist文件夹下得到最终的run.exe文件。

5. 打包后测试、分发与体积优化

打包完成不是终点，严格的测试和优化同样重要。

5.1 在隔离环境测试

这是至关重要的一步。千万不要只在打包的电脑上测试。找一个没有安装 Python、没有安装 Chrome（或版本不同）的 Windows 电脑或虚拟机，将dist/run.exe复制过去，直接双击运行。

观察以下几点：

1. 能否启动？exe 文件是否能正常启动，不报错。
2. 浏览器驱动：首次运行是否会自动下载 chromedriver？下载是否成功？（需要网络）
3. 功能是否正常？浏览器是否能打开，并正确执行你的自动化逻辑（如访问百度并打印标题）。
4. 控制台窗口：如果你的脚本有print语句，PyInstaller 默认会捆绑一个控制台。如果不想显示这个黑窗口（对于GUI工具），可以在打包时加上-w(或--windowed) 参数。但这样你就看不到打印信息了，调试时会很困难，建议初期先保留控制台。

5.2 分发注意事项

• 杀毒软件误报：这是 PyInstaller 打包 exe 的常见问题。因为打包过程会将代码和解释器压缩捆绑，行为上有点像加壳软件，容易被一些激进的杀毒软件（如 Windows Defender、360等）误判为病毒。解决方法：
  • 对你生成的 exe 进行代码签名（购买代码签名证书，成本较高）。
  • 在分发时告知用户，如果被杀毒软件拦截，需要手动添加信任或放行。
  • 将 exe 文件压缩成 zip 再分发，有时可以绕过一些简单的扫描。
• 文件体积：单文件 exe 的体积通常会比较大（几十MB到上百MB），因为包含了 Python 解释器和所有库。这是正常的。
• 运行权限：某些操作（如写入系统目录）可能需要管理员权限。如果脚本需要，可以尝试右键“以管理员身份运行” exe，或者在打包时通过清单文件请求管理员权限（更复杂）。

5.3 体积优化技巧

如果觉得 exe 体积太大，可以尝试以下方法：

1. 使用 UPX 压缩：UPX 是一款可执行文件压缩工具。PyInstaller 可以集成 UPX。首先从 UPX 官网下载 Windows 版本，解压后，在打包时指定 UPX 路径：

   pyinstaller -F --upx-dir=C:\path\to\upx_folder run.py

   这通常能显著减小体积（20%-30%）。
2. 清理不必要的依赖：确保虚拟环境干净，只安装项目必需的包。使用pip list检查。
3. 排除大型、未使用的库：使用--exclude-module谨慎排除。但注意，不要排除 Selenium 运行所必须的模块。
4. 分拆依赖（进阶）：对于超大型项目，可以考虑不打包成单文件，而是分发一个文件夹（-D参数），然后对文件夹内的库文件（.dll, .pyd）单独用 UPX 压缩。或者，将不变的、大的依赖（如 Python 运行时）做成外部组件。

6. 常见问题排查与实战心得

即使按照步骤操作，打包路上也难免会遇到坑。这里记录几个我踩过的，以及社区里高频出现的问题。

**6.1 问题一：运行 exe 报错 “Failed to execute script ‘run’”

这是最笼统的错误，通常意味着你的脚本在运行时抛出了未捕获的异常。要看到具体错误信息，不要使用-w参数，并且最好从命令行启动 exe：

cd /d D:\path\to\dist run.exe

这样错误信息会打印在控制台。常见原因有：

• 模块未找到：PyInstaller 分析遗漏了某些隐藏导入。根据错误信息，使用--hidden-import添加。
• 数据文件未找到：webdriver-manager的配置文件丢失。检查--add-data参数是否正确，以及sys._MEIPASS路径处理代码。
• 动态库缺失：某些库依赖特定的.dll文件。尝试在打包命令中加入--add-binary参数，但这在 Selenium 中较少见。

6.2 问题二：浏览器能启动，但页面空白或 driver 无法连接

• 驱动版本不匹配：这是使用传统方法（手动指定 chromedriver.exe）时最常见的问题。坚持使用webdriver-manager可以根治。
• 浏览器路径问题：如果用户电脑的 Chrome 不是安装在默认路径，Selenium 可能找不到。webdriver-manager和 ChromeDriver 通常会去系统注册表查找，一般没问题。如果遇到，可以在代码中通过chrome_options.binary_location指定 Chrome 可执行文件的绝对路径。
• 用户数据目录冲突：多个实例或已有 Chrome 进程可能导致冲突。在chrome_options中添加--user-data-dir=./temp_profile指定一个独立的临时用户目录。

6.3 问题三：打包过程成功，但 exe 文件异常巨大（>200MB）

• 检查虚拟环境：你是否在全局 Python 环境下打包？这会把所有已安装的库都打进去。务必在干净的虚拟环境中操作。
• 检查引入了大型科学计算库：如numpy,pandas,torch等，它们本身就有几十 MB。如果脚本只用到了其中一小部分功能，看看能否用更轻量的库替代。
• 使用了--onefile但未压缩：确保使用了 UPX。

6.4 问题四：在别人的电脑上运行，提示缺少VCRUNTIME140_1.dll等 DLL

这是因为目标系统缺少 Visual C++ Redistributable 运行时库。Python 3.5+ 构建的包通常依赖 VC++ 2015 或更高版本的运行时。解决方法：

• 让用户安装对应的 Microsoft Visual C++ Redistributable （根据你的 Python 是 32 位还是 64 位选择）。
• 或者，尝试使用旧一点的 Python 版本（如 3.4）打包，但可能带来其他兼容性问题。更推荐第一种方法，并将其作为运行前提写在说明文档里。

6.5 实战心得与建议

1. 迭代打包：不要试图一次就写出完美的打包命令。先pyinstaller run.py生成文件夹版本，在里面测试运行，看缺什么文件，再逐步调整 spec 文件或命令行参数，最后再尝试单文件模式。
2. 善用.spec文件：当命令行参数变得很长很复杂时，使用.spec文件更清晰。运行一次pyinstaller run.py会生成run.spec，你可以编辑这个文件，精确控制打包的每个环节（分析、捆绑、加密等），然后运行pyinstaller run.spec进行打包。
3. 日志是你的朋友：在脚本的关键步骤添加文件日志记录，而不是仅仅print。因为当以-w模式运行时，print是看不到的。使用 Python 的logging模块将日志写入文件，便于排查在用户环境下的问题。
4. 考虑使用auto-py-to-exe：如果你对命令行感到头疼，可以试试auto-py-to-exe这个图形化工具。它本质上是 PyInstaller 的 GUI 封装，可以通过可视化界面配置所有参数，非常适合新手快速上手。安装命令：pip install auto-py-to-exe。

打包 Python Selenium 脚本成 exe，从技术上看，是 PyInstaller 将脚本、解释器、依赖库以及webdriver-manager这样的运行时资源管理器，全部封装进一个 Windows 可执行文件的过程。其真正的挑战不在于打包命令本身，而在于如何处理像浏览器驱动这样强依赖外部环境和版本的组件。通过采用webdriver-manager动态管理驱动，并正确地将它的数据文件打包进去，我们构建了一个足够健壮的交付物。这个 exe 文件，对于使用者而言，就是一个简单的“双击即可运行”的工具；而对于开发者，它背后是一套关于依赖隔离、路径处理和异常应对的完整工程实践。下次当你再需要把一个小巧的自动化想法分享给更多人时，不妨试试这个方法，它会让你和你的脚本都显得更专业。