这个工具能做什么

pxlsgrds-sitemap 是一个基于 Node.js 的命令行工具，核心功能是：从你指定的网址开始，自动爬取同域名下的内部链接，过滤掉图片、CSS、JS 等静态资源，对 URL 做规范化去重，最后输出一份标准的 sitemap.xml 文件。它默认使用广度优先（BFS）策略爬取，适合为传统 HTML 渲染的网站快速生成站点地图。

第一步：为避免入坑，首先确认 Node.js 版本

小编尝试的时候，就出现了上图所示的报错：Error [ERR_REQUIRE_ESM]: require() of ES Module C:\Users\Administrator\AppData\Local\npm-cache\_npx\defc4f7712a3abd8\node_modules\ora\index.js from C:\Users\Administrator\AppData\Local\npm-cache\_npx\defc4f7712a3abd8\node_modules\pxlsgrds-sitemap\dist\cli.js not supported.

Instead change the require of index.js in C:\Users\Administrator\AppData\Local\npm-cache\_npx\defc4f7712a3abd8\node_modules\pxlsgrds-sitemap\dist\cli.js to a dynamic import() which is available in all CommonJS modules.

   at Object.<anonymous> (C:\Users\Administrator\AppData\Local\npm-cache\_npx\defc4f7712a3abd8\node_modules\pxlsgrds-sitemap\dist\cli.js:8:31) {

pxlsgrds-sitemap 依赖了较新版本的 cheerio 和 undici 等库，这些库要求 Node.js 版本不低于 20.18.1，而你当时的环境是 v20.18.0，因此触发了 EBADENGINE 警告，随后又因为 ora 库的 ESM 格式问题直接报错退出。

解决方法：将 Node.js 升级到 v20.19.0 或更高版本（推荐直接装 v22 LTS）。如果你不想动现有的 Node 环境，也可以考虑用 nvm-windows 安装一个新版本并切换过去。升级后，npm 会随 Node.js 一起更新到兼容的版本，不需要单独去装高版本的 npm。

第二步：查看升级并选择合适的Node.js版本

在cmd控制台窗口输入nvm list可以查看node.js版本，然后使用nvm install lts 可以安装 最新的 nodejs LTS 版本。

安装完成后，使用nvm list再看一遍版本，用nvm use 版本号即可切换运行版本  

第二步：运行生成命令

环境就绪后，操作就很简单了，找到需要保存sitemap.xml的文件夹，地址栏输入cmd回车。通过 npx 直接运行，无需全局安装：

npx pxlsgrds-sitemap https://www.114hbs.com

运行结束后，当前目录下会生成一个 sitemap.xml 文件。

常用参数说明

根据你的需求，可能需要调整爬取深度或页面数量上限：

参数 作用 默认值

--depth <n> 最大爬取深度 3

--max-pages <n> 最多爬取页面数 500

--concurrency <n> 并发请求数 5

--output <file> 输出文件名 sitemap.xml