如何将依赖Playwright的Python终端应用打包为EXE文件？

针对依赖Playwright的Python终端应用打包EXE失败的问题，可按以下步骤排查解决：

• 确保浏览器二进制文件被正确引入
  Playwright依赖Chromium/Firefox/WebKit的二进制文件，默认安装路径不在PyInstaller的扫描范围内。执行以下操作：

  1. 重新安装Playwright及完整浏览器依赖：

     pip install --upgrade playwright
     playwright install --with-deps chromium  # 可替换为你实际使用的firefox/webkit
     

  2. 打包时用--add-data参数将浏览器文件加入包中。Windows下可先通过playwright path命令获取浏览器安装路径，再执行打包命令：

     pyinstaller --onefile --add-data "$(playwright path)\chromium;playwright\chromium" main.py
     

     也可在代码中显式指定浏览器路径，避免PyInstaller寻址失败：

     from playwright.sync_api import sync_playwright
     import os
     
     def main():
         with sync_playwright() as p:
             # 路径需对应--add-data的配置规则
             browser_path = os.path.join(os.path.dirname(__file__), "playwright", "chromium", "chrome.exe")
             browser = p.chromium.launch(executable_path=browser_path)
             # 你的业务逻辑代码
             browser.close()
     
     if __name__ == "__main__":
         main()
     

• 使用Playwright专属PyInstaller钩子
  创建名为hook-playwright.py的钩子文件，内容如下：

  from PyInstaller.utils.hooks import collect_data_files, collect_submodules
  
  datas = collect_data_files("playwright")
  datas += collect_data_files("playwright_drivers")
  hiddenimports = collect_submodules("playwright")
  

  打包时指定钩子目录：

  pyinstaller --onefile --additional-hooks-dir=. main.py
  

• 清理PyInstaller缓存
  旧缓存可能导致打包异常，打包时添加--clean参数清空缓存：

  pyinstaller --onefile --clean main.py
  

• 检查虚拟环境与依赖完整性
  确保在激活的虚拟环境内操作，所有依赖（包括Playwright）均安装在该环境中。避免混用全局Python环境，防止路径冲突。

• 定位具体错误
  若仍失败，查看PyInstaller生成的build目录下的日志文件，或观察终端输出的错误提示，根据缺失的文件/模块，针对性添加--add-data或--hidden-import参数。

内容的提问来源于stack exchange，提问作者DanielCoding