在VS Code工作区新增文件夹、移动文件应使用哪个扩展API？

针对你需要实现的「读取工作区文件/文件夹、创建文件夹、移动文件归类」的需求，优先选择vscode.workspace命名空间下的文件系统API，三类API的适用场景差异如下：

• Node.js标准fs模块
  仅可用于本地磁盘文件的读写，无法兼容VS Code的远程工作区（SSH/WSL/Codespaces）、虚拟工作区（如压缩包、云存储映射的工作区）场景。同时直接调用fs操作的文件不会触发VS Code内置的文件变更事件，会导致资源管理器不自动刷新、其他扩展无法感知文件变更的问题。仅在你确定扩展只需要支持纯本地工作区时可选使用。
• FileSystemProvider接口
  该接口的定位是供扩展开发者自定义全新的文件系统类型（比如实现读取压缩包内容作为工作区、对接私有云存储作为工作区的能力），而非操作用户当前已打开的现有工作区文件，完全不匹配你的需求场景。
• workspace命名空间下的workspace.fsAPI
  是VS Code官方提供的标准跨文件系统操作接口，天然兼容本地、远程、虚拟各类工作区场景，所有操作会自动触发VS Code的内置文件事件，资源管理器会同步刷新，其他扩展也能正常感知文件变更，是当前场景的最优选择。

以下是你需要的核心操作示例：

// 1. 获取当前工作区根路径
const workspaceRoot = vscode.workspace.workspaceFolders?.[0]?.uri;
if (!workspaceRoot) return vscode.window.showErrorMessage("未打开任何工作区");

// 2. 读取工作区根目录下的所有文件/文件夹
const entries = await vscode.workspace.fs.readDirectory(workspaceRoot);
entries.forEach(([name, type]) => {
  console.log(`名称：${name}，类型：${type === vscode.FileType.Directory ? '文件夹' : '文件'}`);
});

// 3. 创建新分类文件夹
const newFolderUri = vscode.Uri.joinPath(workspaceRoot, '新分类文件夹');
await vscode.workspace.fs.createDirectory(newFolderUri);

// 4. 移动文件到新文件夹
const sourceFileUri = vscode.Uri.joinPath(workspaceRoot, '旧路径/test.md');
const targetFileUri = vscode.Uri.joinPath(newFolderUri, 'test.md');
// 第三个参数设为true可覆盖同名目标文件
await vscode.workspace.fs.rename(sourceFileUri, targetFileUri, true);

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