这是什么意思?浏览器实机渲染。本机无 jsdom / headless这句话通常是在说明当前环境的限制意思是要验证网页的真实显示效果必须用真正的浏览器来渲染但这台机器上既没有 jsdom也没有 headless 浏览器所以无法在本地自动完成浏览器渲染、截图或前端测试。拆开看浏览器实机渲染把 HTML/CSS/JS 交给真实浏览器内核执行走解析、DOM、CSS 计算、布局、绘制、JS 执行最后显示页面。不是用代码模拟也不是只看源码猜效果。jsdomNode.js 里的 DOM 模拟库可以模拟一部分 DOM 和脚本执行但不做真实布局和绘制不能代替浏览器渲染。headless无界面浏览器比如 Puppeteer / Playwright / Chrome--headless。它虽然没窗口但用的是真实浏览器内核能渲染、截图、跑自动化测试。本机无 jsdom / headless当前机器没有这些工具所以不能自动跑一个“浏览器”来渲染页面。合起来就是如果你想看页面真实效果当前环境没法自动帮你渲染或截图你只能在真实浏览器里手动打开看或者先安装 Playwright/Puppeteer/Chrome headless或者换一台有浏览器环境的机器。补充一句jsdom 不等于实机渲染headless 浏览器算真实内核渲染只是没有界面。如果对方强调“实机”可能是指要有界面的真实浏览器。怎么安装? jsdom / headless安装jsdom和 headless 浏览器都依赖 Node.js 环境所以我会先说明 Node.js 的安装再分别介绍两种工具的安装方式。 前提安装 Node.jsjsdom和主流的 headless 工具如 Puppeteer、Playwright都通过 Node.js 的包管理器npm来安装。如果本机还没有 Node.js需要先去 nodejs.org 下载安装包建议选择 LTS 版本。安装完成后可以在终端运行node -v和npm -v来确认是否成功。 安装 jsdomjsdom的安装非常简单在项目目录下运行以下命令即可npm install jsdom如果希望在所有 Node.js 项目中都能全局使用可以加上-g参数npm install jsdom -g注意全局安装后在分发版本中仍然需要在package.json的dependencies里添加jsdom条目。 安装 headless 浏览器Headless 浏览器有三种主流方案你可以根据需求选择。方案一Puppeteer推荐最省事Puppeteer 是 Google 维护的库安装时会自动下载兼容的 Chrome 浏览器。npm install puppeteer如果只想安装库、不下载 Chrome例如已有本地 Chrome可以改用npm install puppeteer-core需要注意的是新版 npm 等包管理器默认会阻止安装脚本可能导致 Chrome 没有自动下载。如果遇到运行时找不到浏览器的问题可以手动执行npx puppeteer browsers install来补下载。方案二Playwright跨浏览器支持好Playwright 支持 Chromium、Firefox、WebKit安装后需要单独执行命令下载浏览器。# 安装 Playwright 库 npm install playwright/test # 下载所需的浏览器默认会安装 Chromium、Firefox、WebKit npx playwright install如果只需要 Chromium 的 headless shell可以加上--only-shell参数减少下载体积。方案三直接使用 Chrome 的 headless 模式如果本机已经装了 Chrome不需要额外安装任何库直接通过命令行参数调用即可。不同系统的命令如下系统命令Windowsstart chrome --headlessmacOSopen -a Google Chrome --args --headlessLinuxgoogle-chrome --headless这种方式适合简单的截图或页面导出但要做自动化控制如点击、填表就不如 Puppeteer/Playwright 方便。这里我试验了一下,命令应该是:playwright install --only-shell但是因为网络问题,没跑通.✅ 验证安装安装完成后可以快速验证是否可用# 验证 jsdom node -e const { JSDOM } require(jsdom); const dom new JSDOM(pok/p); console.log(dom.window.document.querySelector(p).textContent) # 验证 Puppeteer会启动一个 headless 浏览器并输出页面标题 node -e const puppeteer require(puppeteer); (async () { const b await puppeteer.launch(); const p await b.newPage(); await p.goto(https://example.com); console.log(await p.title()); await b.close(); })()如果两条命令都能正常输出内容就说明安装成功了。 该选哪个只是想在 Node.js 里模拟 DOM 跑测试装jsdom就够了它轻量、启动快但不做真实布局和渲染。需要真实浏览器渲染、截图或自动化操作选Puppeteer或Playwright。Puppeteer 与 Chrome 绑定最深、文档最丰富Playwright 的跨浏览器支持更好API 也更现代。两者都默认以 headless 模式运行不需要额外配置。小浣熊帮着实践安装正确的启动命令cd G:/dswork/AI/deepseek-harness # 启动 Chrome无头 —— 用 open不是 start npx playwright open --browser chrome --headless # 等价别名写法 npx playwright cr --headless # 有头模式 npx playwright open --browser chrome # 指定 Chrome 通道若你本机装了 Chrome npx playwright open --browser chrome --channel chrome以后再遇到镜像超时一键命令$env:PLAYWRIGHT_DOWNLOAD_HOSThttps://npmmirror.com/mirrors/playwright $env:PLAYWRIGHT_DOWNLOAD_CONNECTION_TIMEOUT120000 # 连接超时 120s npx playwright install --only-shellGit Bash / bashexport PLAYWRIGHT_DOWNLOAD_HOSThttps://npmmirror.com/mirrors/playwright export PLAYWRIGHT_DOWNLOAD_CONNECTION_TIMEOUT120000 npx playwright install --only-shell