必须在 new_context() 阶段设置 locale 参数,它会自动同步影响 navigator.language、Accept-Language 请求头及地域跳转逻辑,且不可通过 page 层 JS 覆盖;需配合 timezone_id、geolocation 等参数实现完整地域伪装。

设置 locale 参数必须在 new_context() 阶段完成
Playwright 的语言环境不是靠改系统 locale 或浏览器 UI 设置生效的,而是通过 BrowserContext 初始化时传入 locale 参数来控制。这个参数会同时影响三处关键行为:页面内 navigator.language 值、HTTP 请求头中的 Accept-Language、以及部分网站基于语言自动跳转地域版本的逻辑。
常见错误是试图在 page 层或用 evaluate() 注入 JS 修改 navigator.language —— 这种方式只改了运行时值,Accept-Language 仍为默认(如 en-US),网站后端一查就露馅。
-
locale必须作为字典键传给browser.new_context(),不能写在launch()或new_page() - 值要符合 BCP 47 标准,比如中文简体是
"zh-CN",繁体是"zh-TW",日语是"ja-JP" - 搭配
geolocation和permissions使用效果更稳,例如:new_context(locale="zh-CN", geolocation={"longitude": 121.47, "latitude": 31.23}, permissions=["geolocation"])
仅设 locale 不足以绕过地域拦截,必须同步伪造地理上下文
很多网站不只看语言,还会结合 IP 归属地、时区、地理位置 API 返回值做交叉验证。如果你用的是国内代理 IP,但 navigator.timezone 是 "America/Los_Angeles",或者 Geolocation.getCurrentPosition() 返回美国坐标,照样被识别为异常。
Playwright 允许在 new_context() 中一并注入这些信息:
- 用
timezone_id参数统一设置时区,例如timezone_id="Asia/Shanghai" - 用
geolocation指定经纬度,并用permissions显式授予定位权限 - 注意:这些参数只对当前 context 生效,每个任务需独立配置,不能复用 context
示例代码片段:
context = browser.new_context(
locale="zh-CN",
timezone_id="Asia/Shanghai",
geolocation={"longitude": 121.47, "latitude": 31.23},
permissions=["geolocation"]
)
locale 对请求头和 navigator 属性的影响是自动且不可覆盖的
这是 Playwright 和 Selenium 的关键区别之一。一旦你在 new_context() 中指定了 locale,Playwright 会在底层直接配置 Chromium 的启动参数(如 --lang=zh-CN),并确保所有后续页面加载都继承该设定。你无法用 page.add_init_script() 或 page.evaluate() 覆盖它——因为 navigator.language 和 Accept-Language 是由浏览器进程级参数决定的,JS 层只能读,不能写死。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
验证是否生效的方法很直接:
- 打开 DevTools → Console,执行
navigator.language,应返回你设的值 - 在 Network 面板中点任意请求 → Headers → 查看
Accept-Language是否匹配 - 如果两者不一致,说明你没在
new_context()阶段设,而是在 page 加载后补的,无效
多语言切换不能靠复用 context,必须为每种语言新建独立 context
一个 BrowserContext 实例从创建起就绑定了固定的 locale、timezone_id、geolocation 等参数,运行中无法修改。试图在已有 context 里切换语言,只会导致新页面仍沿用旧配置,旧页面不受影响,结果混乱。
正确做法是按语言维度组织 context:
- 需要中/英双语并行采集?开两个 context,分别设
locale="zh-CN"和locale="en-US" - 不要用
page.goto()后再改语言,那只是前端渲染变化,后端和请求头仍是原样 - 注意资源开销:每个 context 是独立的 Cookie、缓存、存储空间,大量并发时需控制数量
真正容易被忽略的点是:有些网站会把语言偏好存在 localStorage 或 Cookie 里,即使你换了 context,若没清空或隔离好,历史残留可能干扰新请求。所以务必确认每个 context 是全新初始化的,别依赖全局状态。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










