NodeJS+TypeScript环境下如何将DOCX文件转换生成PDF

• @nativedocuments/docx-wasm：该包已停止官方维护，已知存在NodeJS高版本兼容性、架构适配问题，无官方修复路径，建议直接替换为其他维护中的工具。
• word2pdf：原包已归档下架，npm源无法拉取，现有公开fork分支均无后续维护，不建议继续使用该方案。
• docx-pdf：样式丢失问题源于该包默认使用轻量渲染引擎，仅支持基础文本格式。可修改源码将底层渲染逻辑替换为pandoc+headless浏览器的中转链路，即可保留复杂格式，但改造成本较高，更建议直接换完整支持样式的转换工具。
• libreoffice-convert Windows启动报错：该问题为包的默认路径解析逻辑缺陷，非LibreOffice本身损坏，可行修复步骤如下：
  1. 手动指定soffice.exe绝对路径，避免自动检索错误：在调用转换方法时传入sofficePath参数，值为你的LibreOffice安装路径下program/soffice.exe的完整路径，路径含空格时需用双引号包裹
  2. 调用时添加--headless --norestore --nolockcheck启动参数，跳过GUI加载和配置校验
  3. 若仍报错，可将LibreOffice重新安装到无空格、无特殊字符的路径（如D:\LibreOffice），消除路径解析异常

• 方案1：Pandoc + Puppeteer 组合（样式保留率最高）
  该方案先通过Pandoc将DOCX转换为带完整内嵌样式的HTML，再通过Puppeteer启动无头Chrome渲染HTML生成PDF，可1:1保留表格、缩进、两端对齐等复杂格式，适配NestJS+TS环境，示例代码如下：

  import * as puppeteer from 'puppeteer';
  import { exec } from 'child_process';
  import { promisify } from 'util';
  const execAsync = promisify(exec);
  
  async function docxToPdf(docxPath: string, outputPdfPath: string) {
    // 第一步：docx转带样式HTML
    await execAsync(`pandoc -s "${docxPath}" -o temp.html`);
    // 第二步：HTML转PDF
    const browser = await puppeteer.launch({ headless: 'new' });
    const page = await browser.newPage();
    await page.goto(`file://${process.cwd()}/temp.html`, { waitUntil: 'networkidle0' });
    await page.pdf({ path: outputPdfPath, format: 'A4', printBackground: true });
    await browser.close();
  }
  

  需提前在环境中安装Pandoc，TS类型可直接引入@types/puppeteer包获取。
• 方案2：WSL环境下使用LibreOffice无头模式
  Windows开发环境可安装WSL2，在Linux子系统中安装LibreOffice，直接通过子系统命令调用转换，完全规避Windows端的路径、权限问题，转换效率和兼容性远高于Windows原生调用。
• 方案3：同数据源直接生成PDF（无转换损耗）
  若你的DOCX为代码生成的可控文件，可直接使用pdf-lib或jsPDF基于同一数据源生成PDF，格式完全可控，不存在转换丢失问题，适合对格式精度要求极高的场景。

内容的提问来源于stack exchange，提问作者Axel León