Playwright 录制视频需在 browser.new_context() 中指定已存在且有写权限的 record_video_dir 目录，上下文关闭后生成 webm 文件；路径错误、未调用 context.close() 或目录无权限是常见失败原因。
Playwright 录制视频需要启用 record_video_dir 参数
Playwright 本身不提供“录制按钮式”交互录屏，而是通过启动浏览器上下文时指定视频输出目录来开启自动录屏。关键点是：record_video_dir 必须指向一个**已存在的、有写入权限的空目录**，否则会静默失败或报错 PermissionError 或 FileNotFoundError。
常见错误现象：运行后没生成视频、控制台无报错、但 record_video_dir 下空空如也——大概率是目录不存在或路径拼写错误（比如漏了 / 结尾，或用了相对路径但工作目录不对）。
- 必须在
browser.new_context()或browser.new_page()前传入record_video_dir - 推荐用
tempfile.mkdtemp()动态建临时目录，避免硬编码路径 - 视频格式固定为
webm，无法指定 MP4；若需转码，后续用ffmpeg处理 - 每个上下文（
context）独立生成一个视频文件，文件名形如video-123456.webm
完整示例：启动 Chromium 并保存视频到本地指定路径
以下是最小可运行片段，注意 record_video_dir 的位置和目录创建逻辑：
from playwright.sync_api import sync_playwright
import os
<p>with sync_playwright() as p:
browser = p.chromium.launch(headless=False) # headless=True 时仍可录屏</p><h1>✅ 确保目录存在</h1><pre class="brush:php;toolbar:false;">video_dir = "./videos"
os.makedirs(video_dir, exist_ok=True)
context = browser.new_context(
record_video_dir=video_dir, # ⚠️ 必须是字符串路径，不是文件名
viewport={"width": 1280, "height": 720},
)
page = context.new_page()
page.goto("https://example.com")
page.screenshot(path="./example.png")
# ✅ 关闭上下文才能完成视频写入（重要！）
context.close()
browser.close()
立即学习“Python免费学习笔记（深入）”；
执行后，./videos/ 下会出现一个 video-*.webm 文件。若没出现，请检查：os.makedirs 是否真执行了、路径是否被其他进程占用、Linux/macOS 下是否因 SELinux/AppArmor 拦截写入。
异步模式下同样适用 record_video_dir，但要注意 context.close() 时机
使用 async_playwright 时，遗漏 await context.close() 是高频问题——视频文件会停留在“正在写入”状态，大小为 0 字节或不完整。
- 必须用
await context.close()，不能只调context.close() - 若用
async with语法，确保它包裹的是整个上下文生命周期 - 不要在
page.close()后就认为视频已就绪；只有上下文关闭才触发最终 flush - Windows 上若遇到
OSError: [Errno 22] Invalid argument，可能是路径含中文或特殊符号，换英文路径重试
视频尺寸和帧率不可直接配置，但可通过 viewport 和设备模拟间接影响
Playwright 不暴露 framerate、bitrate 等参数。实际录制效果取决于：
-
viewport尺寸：越大，视频分辨率越高，文件体积越大 - 是否启用
device_scale_factor（如设为 2 会放大渲染，但不提升清晰度，仅影响 UI 缩放） - 页面内容动态程度：动画/滚动越频繁，视频数据量越大
- 底层 Chromium 版本：新版 Playwright（v1.40+）对 WebM 编码优化更好，卡顿更少
如果发现视频卡顿严重，优先检查是否在 headless=False 下启用了 GPU 加速缺失（Linux 常见），可加启动参数：chromium.launch(args=["--use-gl=swiftshader"])。
真正容易被忽略的一点：视频文件不会在 page.close() 时生成，也不会在 browser.close() 时补全——它只依赖 context.close() 的完成。很多脚本把上下文关早了（比如在跳转前就关），或者用 try/finally 但忘了 await，结果白跑一趟。
