在 VS Code 扩展中直接导入 dir-compare 默认导出会导致 compare is not a function 错误；需改用命名导入（如 compareSync）并避免对 Promise 拒绝对象直接 JSON.stringify()，否则错误信息将为空。
在 vs code 扩展中直接导入 `dir-compare` 默认导出会导致 `compare is not a function` 错误；需改用命名导入（如 `comparesync`）并避免对 promise 拒绝对象直接 `json.stringify()`，否则错误信息将为空。
VS Code 扩展运行于受限的 Node.js 环境（通常为 Extension Host 进程），其模块解析和 ES 模块支持与普通 Node 脚本存在差异。dir-compare 包未提供标准的 CommonJS 默认导出，其 ESM 导出形式为命名导出（compareSync, compare, compareAsync），因此以下写法会失败：
// ❌ 错误：默认导入在扩展环境中无法正确解析 import dircompare from 'dir-compare'; // → dircompare 为 undefined dircompare.compare(...); // TypeError: Cannot read properties of undefined (reading 'compare')
✅ 正确做法是显式导入所需函数，并优先选用同步方法（compareSync），因其不依赖异步上下文、调试友好、且规避了 Promise 捕获陷阱：
import { compareSync } from 'dir-compare';
const path1 = 'C:/a';
const path2 = 'C:/b';
try {
const result = compareSync(path1, path2);
terminal.sendText(`echo "Success: ${JSON.stringify(result)}"`);
} catch (err) {
// ⚠️ 关键：不要用 JSON.stringify(err) —— Error 实例不可枚举，会返回 {}
terminal.sendText(`echo "Error: ${err?.message || 'Unknown error'}"`);
}
若必须使用异步版本（如处理超大目录需避免阻塞 UI），请确保正确捕获 Promise rejection 并提取有效信息：
import { compare } from 'dir-compare';
compare(path1, path2)
.then(res => terminal.sendText(`echo "OK: ${JSON.stringify(res)}"`))
.catch(err => {
// ✅ 正确获取错误信息
const errorMsg = err instanceof Error ? err.message : String(err);
terminal.sendText(`echo "Failed: ${errorMsg}"`);
});
? 注意事项：
-
dir-compare的compare()返回 Promise，但其底层依赖fs模块，在某些 VS Code 扩展沙箱配置下可能受限（尤其 Web Extension Host）；推荐先验证compareSync是否满足需求。 - 确保
dir-compare已作为dependencies（非devDependencies）安装，并在package.json中声明，否则打包后可能缺失。 - 若仍报错，请检查路径权限（Windows 下
C:/a需确保扩展有读取权限）及路径真实性（建议先用fs.existsSync()验证）。
通过规范导入方式 + 合理错误处理，即可在 VS Code 扩展中稳定、可调试地完成目录比对任务。
