安装过程屡遭挫折，参考了这篇文章才成功(Playwright Chromium 安装避坑指南 (Windows 国内环境))，特记录
**关键：安装“黄金版本” (Playwright 1.48.0) **
:: 1. 初始化项目 (选择 TypeScript, 不下载浏览器)
npm init playwright@latest
:: (交互时：Install browsers? 选 No)
:: 2. 强制降级到 1.48.0
npm uninstall @playwright/test playwright
npm install @playwright/test@1.48.0
:: 设置镜像环境变量 set PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright :: 仅安装 chromium npx playwright install chromium
核心知识点总结: 经验法则：如果遇到 headless-shell 404 错误，不要尝试修复网络，直接降级 Playwright 版本到 1.48.0 是最快的解决路径。
1. 版本对应关系 (Version Mapping)#
Playwright 的核心库版本与浏览器二进制版本是严格绑定的，不能混用。
@playwright/test@1.50.0 ➔ 需要 chromium-12xx (国内镜像可能缺失)
@playwright/test@1.48.0 ➔ 需要 chromium-1148 (推荐, 国内镜像完整)
@playwright/test@1.46.0 ➔ 需要 chromium-1140
跟chromium驱动的对应关系
[DIR] android/ 2026-04-03T15:10:23.992Z -
[DIR] chromium-headless-shell/ 2025-02-07T15:09:11.520Z -
[DIR] chromium-tip-of-tree/ 2026-01-22T15:37:30.761Z -
[DIR] chromium-with-symbols/ 2024-05-06T18:10:22.014Z -
[DIR] chromium/ 2026-01-22T15:37:30.761Z -
[DIR] driver/ 2026-04-03T15:10:23.992Z -
[DIR] ffmpeg/ 2026-04-03T15:10:23.992Z -
[DIR] firefox-beta/ 2026-04-03T15:10:23.992Z -
[DIR] firefox/ 2026-04-03T15:10:23.992Z -
[DIR] webkit/ 2026-01-26T15:29:25.081Z -
[DIR] winldd/ 2026-04-03T15:10:23.992Z -
- chromimu/firefox/webkit等下面才是浏览器驱动， driver下面是playwright的驱动 * 运行完“npm init playwright@latest”之后， 在node_modules\playwright-core\下找到 browsers.json， 查看内容：
"browsers": [
{
"name": "chromium",
"revision": "1140",
"installByDefault": true,
"browserVersion": "130.0.6723.31"
}
这里"130.0.6723.31"就是驱动的版本号， 对应目录 1140, 再到 chromium目录下，查看如果有 1140， 说明这个版本可以正常安装 就用这个方法安装正确的playwright版本，不要安装 @latest
