在 VS Code 扩展开发中，process.cwd() 默认指向扩展自身目录而非用户打开的项目路径；本文介绍为何如此、为何不能直接 process.chdir()，并提供安全可靠的替代方案——通过 vscode.workspace.rootPath 或 vscode.workspaceFolders 动态获取真实项目路径。
在 vs code 扩展开发中，`process.cwd()` 默认指向扩展自身目录而非用户打开的项目路径；本文介绍为何如此、为何不能直接 `process.chdir()`，并提供安全可靠的替代方案——通过 `vscode.workspace.rootpath` 或 `vscode.workspacefolders` 动态获取真实项目路径。
process.cwd() 在 VS Code 扩展环境中始终返回扩展主进程（Extension Host）的启动工作目录，即你本地克隆或开发的扩展项目根路径（如 /home/me/path-of-extension），而非用户正在编辑的目标工作区路径（如 /home/me/game-project）。这是 Node.js 运行时的固有行为：VS Code 启动 Extension Host 时以扩展包所在目录为 cwd，且该值在进程生命周期内不可安全修改——强行调用 process.chdir() 不仅可能破坏 VS Code 内部模块加载路径，还易引发权限异常或资源访问失败，因此官方明确不推荐此做法。
✅ 正确做法是放弃依赖 process.cwd()，转而使用 VS Code API 提供的 workspace 信息：
import * as vscode from 'vscode';
export function playGame() {
// ✅ 获取当前打开的工作区根路径（多根工作区时取第一个）
const workspaceFolder = vscode.workspace.workspaceFolders?.[0];
if (workspaceFolder) {
console.log('Project root:', workspaceFolder.uri.fsPath); // e.g. /home/me/game-project
// 后续操作可基于此路径构建文件路径
const gameConfigPath = vscode.Uri.joinPath(workspaceFolder.uri, 'game.config.json');
} else {
vscode.window.showWarningMessage('No folder opened in workspace.');
}
}
对于多根工作区（Multi-root Workspace），应遍历 vscode.workspace.workspaceFolders 并根据上下文选择合适根目录（例如依据当前活动编辑器所在文件夹）：
export function getActiveProjectRoot(): string | undefined {
const editor = vscode.window.activeTextEditor;
if (editor) {
const docUri = editor.document.uri;
const folder = vscode.workspace.getWorkspaceFolder(docUri);
return folder?.uri.fsPath;
}
return vscode.workspace.workspaceFolders?.[0]?.uri.fsPath;
}
⚠️ 注意事项：
- vscode.workspace.rootPath 已被弃用（自 VS Code 1.74+），请务必使用 vscode.workspace.workspaceFolders；
- workspaceFolders 可能为空（如仅打开单个文件未打开文件夹），需做空值判断；
- 所有路径操作建议使用 vscode.Uri.joinPath() 而非字符串拼接，确保跨平台兼容性（自动处理 / 与 \）；
- 切勿在扩展激活前（activate 函数外）访问 workspace API，否则会报错“workspace not available”。
总结：process.cwd() 在扩展中不具备语义意义，它反映的是运行环境而非用户上下文。真正代表“用户当前项目”的是 vscode.workspace.workspaceFolders。拥抱 VS Code 的 API 设计范式，才能写出健壮、可维护、符合平台规范的扩展逻辑。
