用 puppeteer 脚本可实现 html 批量转 PDF 并自动对应文件名：读取 HTML 列表，用 replace(/.html$/, ‘.pdf’) 替换后缀，path.join() 拼接输出路径，setContent() 避免中文文件名解析错误。
HTML 文件批量转 PDF 时，文件名怎么自动对应？
直接用浏览器“打印→另存为 PDF”无法批量处理，更不会保留原始 HTML 文件名。真正可行的批量命名转换，得靠命令行工具或脚本控制输出路径和文件名。
用 puppeteer 脚本实现 HTML 到 PDF 的精准命名
node.js 生态中，puppeteer 是最可控的方式：它能加载本地 HTML、等页面渲染完成、再调用 page.pdf() 输出，并自由拼接目标文件名。
- 输入 HTML 文件名是
report_20240501.html，输出就该是report_20240501.pdf，不能硬编码成output.pdf - 关键在读取
fs.readdirSync()获取 HTML 列表，再对每个文件名做.replace(/.html$/, '.pdf') - 注意路径处理：用
path.join()拼接输出目录，避免 windows 下反斜杠导致写入失败 - PDF 选项里加
printBackground: true，否则 css 中的背景色/图可能丢失
const puppeteer = require('puppeteer'); const fs = require('fs'); const path = require('path'); (async () => { const browser = await puppeteer.launch(); const page = await browser.newPage(); const htmlDir = './html'; const pdfDir = './pdf'; if (!fs.existsSync(pdfDir)) fs.mkdirSync(pdfDir); fs.readdirSync(htmlDir) .filter(f => f.endsWith('.html')) .forEach(async (file) => { const htmlPath = path.join(htmlDir, file); const pdfPath = path.join(pdfDir, file.replace(/.html$/, '.pdf')); await page.goto(`file://${path.resolve(htmlPath)}`, { waitUntil: 'networkidle0' }); await page.pdf({ path: pdfPath, format: 'A4', printBackground: true }); console.log(`✅ ${pdfPath}`); }); await browser.close(); })();为什么不用 wkhtmltopdf 直接批量？
wkhtmltopdf 命令行确实支持批量，但「命名一致性」容易翻车：
- 它不内置文件名替换逻辑，
wkhtmltopdf *.html out.pdf会把所有 HTML 合并进一个 PDF，且名字固定为out.pdf - 想逐个生成，得靠 shell 循环：
for f in *.html; do wkhtmltopdf "$f" "${f%.html}.pdf"; done—— 但 macOS / linux 的sh不支持${f%.html}，得用bash显式运行 - Windows cmd 几乎无法可靠做字符串截取，PowerShell 可以但语法割裂，跨平台维护成本高
- 更重要的是：
wkhtmltopdf对现代 CSS（flex/Grid/变体字体）支持弱，常出现布局错位，而puppeteer基于 Chromium，兼容性好得多
PDF 输出路径和中文文件名的坑
如果 HTML 文件名含中文（如 用户统计.html），直接传给 page.pdf() 在某些系统上会报 ERR_INVALID_ARGUMENT 错误。
立即学习“前端免费学习笔记（深入）”；