VS Code扩展调试时process.cwd()返回路径异常的解决咨询

首先要明确：VS Code的扩展宿主进程是从扩展自身目录启动的，所以默认process.cwd()返回扩展路径是正常行为。强行在扩展启动时全局修改process.cwd()不推荐，会影响其他扩展或VS Code自身的运行逻辑。推荐用以下两种方式处理：

方法一：通过VS Code API获取目标项目路径（优先推荐） #

利用VS Code提供的工作区API直接获取当前打开项目的路径，无需依赖process.cwd()：

import * as vscode from 'vscode';

// 获取当前打开的目标项目根路径
function getProjectRootPath(): string | undefined {
  const workspaceFolders = vscode.workspace.workspaceFolders;
  if (workspaceFolders?.length) {
    // 返回第一个工作区文件夹的本地文件系统路径
    return workspaceFolders[0].uri.fsPath;
  }
  // 处理没有打开工作区的情况
  return undefined;
}

// 在你的函数中使用
export function playGame() {
  const projectPath = getProjectRootPath();
  if (projectPath) {
    console.log(projectPath); // 输出目标项目路径：/home/me/game-project
  } else {
    console.log("请打开一个项目工作区");
  }
}

如果你的依赖代码需要用到项目路径，优先直接传递这个projectPath参数，而不是让依赖读取process.cwd()，这是最安全的做法。

方法二：临时切换工作目录（针对硬编码依赖process.cwd()的场景） #

如果某些依赖代码硬编码使用process.cwd()，无法传递路径参数，可以在调用这些代码前临时切换工作目录，执行完成后再切回原路径：

import * as vscode from 'vscode';

export function playGame() {
  const originalCwd = process.cwd();
  const projectPath = vscode.workspace.workspaceFolders?.[0].uri.fsPath;

  if (projectPath) {
    process.chdir(projectPath);
  }

  try {
    console.log(process.cwd()); // 此时输出目标项目路径
    // 执行依赖的代码逻辑
  } finally {
    // 无论执行结果如何，切回原工作目录，避免影响其他逻辑
    process.chdir(originalCwd);
  }
}

注意事项 #

• 绝对不要在扩展激活时全局修改process.cwd()，这会污染VS Code的扩展宿主环境，影响其他扩展的正常运行。
• 处理边界情况：如果用户没有打开任何工作区（比如只打开了单个文件），workspaceFolders会是undefined，需要给用户相应的提示。

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