VSCode本身不提供Node.js的“压缩与解压环境”配置，实际依赖zlib、archiver等库或系统命令，所有操作均以node命令可用为前提；需在系统终端验证node -v/npm -v，正确配置PATH并重启VSCode，再用path.resolve()处理路径、fs.mkdirSync()创建目录、unzipper/yauzl注意路径安全与编码，调试时必须在launch.json中显式指定runtimeExecutable。
VSCode 本身不提供 Node.js 的“压缩与解压环境”配置——它不内置文件归档能力，也不参与 Node.js 运行时的打包或解包逻辑。所谓“压缩与解压”，实际是调用 Node.js 的 zlib 模块、第三方库（如 archiver、unzipper）或系统命令（tar、unzip）完成的，VSCode 只负责编辑、运行和调试这些代码。
node -v 和 npm -v 报错时，压缩/解压脚本根本跑不起来
所有基于 Node.js 的文件处理脚本（比如用 archiver 打 zip，或用 unzipper 解压）都依赖 node 命令可用。一旦终端里 node -v 报 command not found 或空输出，后续一切操作都会失败。
- 必须在**系统终端**（不是 VSCode 内置终端）中验证：
node -v和npm -v都要输出版本号 - Windows 用户避免路径含空格或中文，例如
C:\Program Files\nodejs\或D:\软件\nodejs\—— 安装时勾选 “Add to PATH”，或手动把完整路径（不含末尾反斜杠）加进系统环境变量Path - macOS/Linux 用户检查
~/.zshrc或~/.bash_profile是否导出正确路径，例如export PATH="/opt/homebrew/bin:$PATH" - 改完环境变量后，**必须完全退出 VSCode 并重启**，否则内置终端仍读不到新 PATH
用 archiver 压缩目录时，常见路径错误和权限问题
archiver 是最常用的 Node.js 压缩库，但它对路径非常敏感：相对路径易错位，绝对路径写错会静默失败或写入错误位置。
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 不要直接用
__dirname + '/src'拼接源路径——确保该路径存在且可读：fs.existsSync()先校验 - 目标 zip 文件路径建议用
path.resolve()转为绝对路径，避免因工作目录不同导致输出到意外位置 - Windows 下若 zip 输出到
C:\根目录，可能因权限被拦截；推荐输出到项目内，如./dist/archive.zip - 压缩前记得
fs.mkdirSync('./dist', { recursive: true })，否则archiver不会自动创建父目录 - 示例关键片段：
const archiver = require('archiver');<br>const output = fs.createWriteStream(path.resolve(__dirname, './dist/archive.zip'));<br>const archive = archiver('zip', { zlib: { level: 9 } });<br>archive.directory('./src', false);<br>archive.pipe(output);<br>archive.finalize();
解压 zip 文件时，unzipper 与 yauzl 的行为差异
Node.js 解压没有统一标准库，unzipper 和 yauzl 是两个主流选择，但默认行为不同，容易踩坑。
-
unzipper默认解压会保留原始 zip 内的目录结构，且支持流式解压（适合大文件），但需注意它不自动创建缺失父目录——要用entry.autodrain()或手动fs.mkdirSync(path.dirname(entry.path), { recursive: true }) -
yauzl更底层，不带自动解压逻辑，必须配合fstream或fs.promises.writeFile逐个写入，灵活性高但代码量翻倍 - 若 zip 含中文路径，
unzipper在 Windows 上可能乱码，需加选项：{ decodeStrings: false }并自行用iconv-lite转码 - 别在
process.cwd()目录直接解压未校验的 zip——恶意 zip 可能含../../../etc/passwd类路径，应先过滤路径：!entry.path.startsWith('../')
调试压缩/解压脚本时，launch.json 必须指定 runtimeExecutable
如果你用 VSCode 调试一个调用了 zlib.gzip 或 archiver 的脚本，而系统装了多个 Node.js 版本（比如 nvm 管理的 v16/v18/v20），不显式指定 runtimeExecutable 就可能触发奇怪问题：gzip 压缩率异常、解压后文件损坏、甚至 zlib 报 ERR_ZLIB_UNKNOWN 错误。
- 在项目根目录建
.vscode/launch.json，写入：{<br> "version": "0.2.0",<br> "configurations": [<br> {<br> "type": "node",<br> "request": "launch",<br> "name": "Run compress",<br> "skipFiles": ["<node_internals>/**"],<br> "program": "${workspaceFolder}/compress.js",<br> "runtimeExecutable": "/usr/local/bin/node"<br> }<br> ]<br>} - macOS/Linux 路径通常是
/usr/local/bin/node或$(which node)；Windows 是C:\nodejs\node.exe或nvm对应路径（如C:\Users\XXX\nvm\v18.17.0\node.exe） - 在脚本里加
console.log(process.execPath)，对比终端执行和调试器里输出是否一致，不一致就说明runtimeExecutable没配对
真正麻烦的不是写几行压缩代码，而是路径拼错、权限卡住、多版本 Node.js 混用、以及 zip 中的路径遍历风险——这些细节不验证，脚本在本地跑通，一上 CI 或换台机器就挂。
