如何配置Puppeteer缓存目录？配置文件未生效求助

以下是针对性的排查和解决步骤：

• 确认配置文件的位置与命名
  配置文件必须放在项目根目录，命名严格为.puppeteerrc.cjs（注意开头的英文句号，后缀为cjs），不要写成puppeteerrc.cjs或.puppeteerrc.js，否则Puppeteer无法识别。

• 验证配置是否被加载
  你的配置文件里添加了console.log语句，重新安装Puppeteer时，如果终端输出Puppeteer config loaded和对应的缓存路径，说明配置已被读取；如果没有输出，说明配置文件未被识别，此时要检查是否在配置文件所在的目录执行npm install puppeteer命令。

• 检查版本兼容性
  Puppeteer v19及以上版本才正式支持.puppeteerrc.cjs配置方式，执行npm list puppeteer查看当前版本，若版本过低，升级到最新稳定版：

  npm install puppeteer@latest
  

• 彻底清理后重新安装
  先卸载Puppeteer并清除npm缓存，避免旧缓存干扰：

  npm uninstall puppeteer
  npm cache clean --force
  

  回到项目根目录，重新执行安装命令：

  npm install puppeteer
  

  若安装过程中看到配置里的日志输出，说明配置生效，.cache/puppeteer目录会自动生成并下载浏览器文件。

• 排查环境变量干扰
  如果系统或终端中设置了PUPPETEER_CACHE_DIR环境变量，会优先覆盖配置文件的cacheDirectory设置。执行对应命令检查：

  • Linux/macOS：echo $PUPPETEER_CACHE_DIR
  • Windows：echo %PUPPETEER_CACHE_DIR%
    若存在该变量，临时取消后再重新安装Puppeteer。

• 手动指定缓存目录（备选方案）
  若上述方法均无效，可在代码中直接指定缓存路径，跳过配置文件：

  const puppeteer = require('puppeteer');
  const { join } = require('path');
  
  (async () => {
    const browser = await puppeteer.launch({
      executablePath: puppeteer.executablePath({
        cacheDirectory: join(__dirname, '.cache', 'puppeteer')
      })
    });
    // 业务逻辑代码
    await browser.close();
  })();
  

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