VSCode扩展运行依赖时如何使用当前工作区目录而非VSCode目录

问题背景 #

• 基于团队自研CLI开发VS Code扩展，CLI典型调用命令如下：

myCLI retrieve SourceName

• CLI运行要求：必须在完成初始化配置的项目目录（例：c:/workspace/myproject）下执行，目录内存放配置文件settings.json
• CLI架构：核心逻辑方法（如retrieve）直接对外暴露，CLI入口仅做参数解析的薄封装
• 现存问题：扩展内直接引入调用CLI暴露的方法时，程序默认从VS Code安装目录C:/Program Files/Microsoft VS Code下查找资源，无法读取项目目录下的配置
• 方案约束条件：
  • 项目遵循CommonJS规范，暂不使用ESM
  • CLI内部硬编码读取相对路径./settings.json，不支持传入全量路径参数，资源查找逻辑完全依赖进程执行时的工作目录
  • 不采用子进程方式调用CLI命令，需直接集成CLI方法到扩展逻辑中，保障交互流畅度

可行实现方案 #

临时切换进程工作目录 #

Node.js原生提供process.chdir()方法可修改当前进程的工作目录，在调用CLI方法前切换到目标工作区路径，调用完成后还原原始工作目录即可，无需修改CLI源码。

1. 依赖VS Code官方API获取当前工作区根路径：

const vscode = require('vscode');

const getWorkspaceRoot = () => {
  const folders = vscode.workspace.workspaceFolders;
  if (!folders?.length) {
    throw new Error('未检测到打开的工作区，请先打开初始化完成的项目目录');
  }
  // 单工作区场景取第一个根目录即可，多工作区场景可根据文件所属目录匹配对应根路径
  return folders[0].uri.fsPath;
};

2. 封装通用调用包装器，自动完成目录切换与还原：

const myCli = require('myCLI');

// 同步方法调用包装
const callCliSync = (method, ...args) => {
  const originCwd = process.cwd();
  const targetCwd = getWorkspaceRoot();
  try {
    process.chdir(targetCwd);
    return myCli[method](...args);
  } finally {
    // 无论方法执行成功或抛出异常，都必须还原原始工作目录，避免影响扩展其他逻辑
    process.chdir(originCwd);
  }
};

// 异步方法调用包装
const callCliAsync = async (method, ...args) => {
  const originCwd = process.cwd();
  const targetCwd = getWorkspaceRoot();
  try {
    process.chdir(targetCwd);
    return await myCli[method](...args);
  } finally {
    process.chdir(originCwd);
  }
};

3. 业务逻辑中直接调用包装后的方法即可，无需额外处理路径：

// 等价于在项目根目录执行 myCLI retrieve SourceName
const res = callCliSync('retrieve', 'SourceName');

注意：如果CLI方法内部存在异步回调、微任务逻辑，必须使用异步包装器搭配await调用，确保工作目录在CLI方法完全执行完成前不会被提前还原。

内容的提问来源于stack exchange，提问作者Doug