vscode无法直接用node将word转pdf，必须依赖外部工具libreoffice；需正确配置soffice环境变量，推荐使用office-to-pdf库，并通过vscode task实现一键转换。
VSCode里不能直接用Node转Word为PDF
VSCode本身不提供Word→PDF的内置转换能力，node 也**无法单独完成这个任务**——它没有解析.docx结构或渲染排版的能力。所有可行方案都依赖外部二进制工具（主要是libreoffice），Node只负责调用命令、传参、读写文件。
必须先装好libreoffice并确保soffice可用
这是整个流程的前提，也是90%失败的根本原因。不是“装了就行”，而是要让soffice命令能在终端任意位置执行成功：
- macOS：默认安装后
soffice在/Applications/LibreOffice.app/Contents/MacOS/soffice，需把该路径加进$PATH（例如在~/.zshrc中加export PATH="/Applications/LibreOffice.app/Contents/MacOS:$PATH"）；软链接到/usr/local/bin大概率失败（报No Info.plist file） - Ubuntu/Debian：
apt install libreoffice-writer即可，但注意libreoffice-pdfimport和中文字体（如ttf-wqy-zenhei）要额外装，否则中文乱码 - Windows：下载安装LibreOffice后，把
Program Files\LibreOffice\program加入系统环境变量PATH，重启终端验证soffice --version
没通过这步，后面所有Node代码都会卡在spawn ENOENT或command not found。
Teleport tsh SSH (Identity-First SSH Access, no passwords/static keys)
下载
使用tbot机器ID身份文件配合tsh CLI，通过Teleport访问控制SSH登录托管主机或执行远程命令。
推荐用office-to-pdf，别手写exec
虽然可以用child_process.exec拼接soffice --headless --convert-to pdf...，但容易出路径空格、编码、超时等问题。更稳的选择是封装好的office-to-pdf：
-
npm install office-to-pdf（注意不是office-pdf或docx-pdf） - 它内部已处理临时目录、参数转义、退出码判断，还支持Buffer输入（适合从HTTP上传流直接转）
- 示例代码简洁：
const toPdf = require('office-to-pdf');<br>const fs = require('fs');<br>const docxBuffer = fs.readFileSync('input.docx');<br>toPdf(docxBuffer).then(pdfBuffer => {<br> fs.writeFileSync('output.pdf', pdfBuffer);<br>}); - 不支持自定义页边距、纸张大小等——这些
libreoffice本身就不支持命令行微调，得靠另存为.odt再转，或换docxtemplater + pdfmake组合（但后者不真正“转Word”，而是重绘PDF）
VSCode里触发转换，得靠Task或插件桥接
VSCode没有“右键Word文件→导出为PDF”功能。想在编辑器里一键操作，必须自己搭桥：
- 写一个
word-to-pdf.js脚本，接收process.argv[2]作为.docx路径，调用office-to-pdf，输出到同目录.pdf - 在
.vscode/tasks.json里配Shell Task：{<br> "label": "Convert Word to PDF",<br> "type": "shell",<br> "command": "node word-to-pdf.js ${file}",<br> "group": "build"<br>} - 按
Ctrl+Shift+P→ “Tasks: Run Task” → 选它，就能转当前打开的.docx - 注意：
${file}是绝对路径，确保脚本里能正确读取；如果路径含空格，office-to-pdf会自动处理，但自己用exec就得手动加引号
真正麻烦的从来不是代码几行，而是libreoffice的安装路径、字体、权限、编码——这些全得在系统层搞定，Node只是个听话的传令兵。
