puppeteer 安装时跳过 chrome 安装的方法

共计 2020 个字符，预计需要花费 6 分钟才能阅读完成。

提醒：本文最后更新于2025-07-07 14:51，文中所关联的信息可能已发生改变，请知悉！

puppeteer 安装时跳过 chrome 安装的方法

puppeteer 安装时跳过下载 chrome

在项目目录里安装 puppeteer 时，都会下载 Chromium。这个慢不说，也会造成重复下载、耗时过长等问题。那么可以这么来做跳过 Chromium 的下载：

npm install puppeteer --ignore-scripts

然后在脚本中通过配置项 executablePath，指定 Chromium 所在的位置（也可以指定为本地 Chrome 浏览器安装的地址）。示例：

const puppeteer = require('puppeteer');
puppeteer.launch({
    headless: false,
    // executablePath: 'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
    executablePath: 'C:\\Program Files\\nodejs\\node_modules\\puppeteer\\.local-chromium\\win64-508693\\chrome-win32\\chrome.exe'
}).then(async browser => {
  const page = await browser.newPage();
  await page.goto('https://lzw.me');
  await page.screenshot({path: 'lzwme.png'});
  browser.close();
}).catch(err => {
    console.log(err);
});

提示：

当前淘宝仓库已经有该镜像，可以通过设置环境变量方式从该镜像地址进行下载安装。命令示例：

# window
set PUPPETEER_DOWNLOAD_HOST=https://npm.taobao.org/mirrors 
npm install puppeteer

手动下载 chrome

有的同学可能会问，在墙里下载不到开发版的 chrome 怎么办。翻看仓库源码可以得知，下载地址是这样的：

const downloadURLs = {
  linux: 'https://storage.googleapis.com/chromium-browser-snapshots/Linux_x64/%d/chrome-linux.zip',
  mac: 'https://storage.googleapis.com/chromium-browser-snapshots/Mac/%d/chrome-mac.zip',
  win32: 'https://storage.googleapis.com/chromium-browser-snapshots/Win/%d/chrome-win32.zip',
  win64: 'https://storage.googleapis.com/chromium-browser-snapshots/Win_x64/%d/chrome-win32.zip',
};

选择对应的平台，将 %d 替换成具体的编号，然后使用迅雷这种 P2P 下载即可。这个编号可以从 puppeteer/package.json 中的 puppeteer.chromium_revision 字段获得。

另外，你也可以从淘宝镜像仓库进行下载，地址如下：

https://npm.taobao.org/mirrors/chromium-browser-snapshots/

相关参考：

https://github.com/GoogleChrome/puppeteer/issues/244
https://github.com/GoogleChrome/puppeteer/issues/288

关于 puppeteer

在以前，当需要进行无界面的浏览器自动访问网站执行动作时，大都会选择 phantomjs 或 SlimerJS。

在 https://lzw.me/a/slimerjs-phantomjs-casperjs.html 这篇文章中我们对 phantomjs 进行了简单的使用介绍。

puppeteer 则是 chrome 官方团队出品的同类工具。当 puppeteer 出来后，phantomjs 即宣布不再继续开发维护。puppeteer 的使用很简单，功能更丰富，可以通过脚本实现各种自动化功能需求。

本文不对 puppeteer 具体使用作详细介绍。关于 puppeteer 的使用示例可参考这几篇文章：

https://github.com/laispace/puppeteer-explore
https://github.com/zhentaoo/puppeteer-deep
https://cloud.tencent.com/community/article/529168
https://github.com/GoogleChrome/puppeteer