Puppeteer启动配置求助：同时设置--no-sandbox与headless:false失败

嘿，我一眼就瞅出问题在哪啦——你写错了Puppeteer启动配置的对象语法，导致代码没法正常运行。

问题根源 #

你尝试把args和headless拆成两个对象传递，但Puppeteer的launch方法只接受一个配置对象，所有参数都得放在同一个大括号里，用逗号分隔不同配置项。你原来的错误写法：

// 语法错误：不符合JavaScript对象规范
const browser = await puppeteer.launch({args: ['--no-sandbox']} headless: false});

这种写法JavaScript引擎根本解析不了，自然会报错。

正确写法 #

把所有配置项统一放在一个对象里就好，调试时的完整代码应该是这样：

// 正确写法：所有配置项在同一个对象内
const browser = await puppeteer.launch({
  args: ['--no-sandbox'],
  headless: false
});

进阶优化：根据环境自动切换配置 #

如果想在开发调试时自动启用可视化界面，生产环境保持无头模式，可以结合环境变量实现自动切换：

// 判断当前是否为调试/开发环境
const isDebugMode = process.env.NODE_ENV === 'development';

const browser = await puppeteer.launch({
  args: ['--no-sandbox'],
  // Puppeteer v19+推荐用'new'代替true，更贴合现代浏览器行为
  headless: isDebugMode ? false : 'new'
});

这样就不用每次手动修改代码，能轻松在两种模式间切换啦～

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