能否使用findFiles API查询workspaceFolders范围外的文件？

vscode.workspace.findFiles() 接口本身的设计限制为仅扫描当前打开的工作区文件夹（workspaceFolders）范围内的文件，原生不支持直接检索工作区外的路径，可通过以下两种方案实现需求：

方案1：使用Node.js原生文件API检索（优先推荐） #

VS Code扩展运行在Node.js环境中，可直接使用文件系统相关的工具包实现任意路径的文件检索，不会触发工作区变更，用户无感知，实现逻辑如下：

• 选择fast-glob、glob等支持通配符匹配的第三方包作为检索工具
• 传入你需要检索的外部目录绝对路径作为搜索根目录，自定义匹配规则即可

示例代码：

const fg = require('fast-glob');
// 替换为你要检索的外部目录绝对路径
const searchRoot = '/Users/xxx/Documents/external-folder';

// 示例：搜索该目录下所有的.md格式文件
const matchedFiles = await fg('**/*.md', {
  cwd: searchRoot,
  absolute: true, // 返回结果为绝对路径
  onlyFiles: true, // 只返回文件，排除目录
  followSymlinks: false // 不跟随软链接，按需开启
});

如果需要用户授权访问外部目录，可先调用vscode.window.showOpenDialog让用户手动选择目标目录，拿到路径后再执行上述检索逻辑，符合VS Code的权限设计要求。

方案2：临时添加外部路径到工作区后调用findFiles #

如果必须使用vscode.workspace.findFiles接口，可先将目标外部路径临时添加到当前工作区，检索完成后再移除，实现逻辑如下：

import * as vscode from 'vscode';

// 目标外部目录的URI
const externalFolderUri = vscode.Uri.file('/path/to/your/external/folder');
const workspaceFolders = vscode.workspace.workspaceFolders ?? [];

// 1. 临时添加目录到工作区末尾
vscode.workspace.updateWorkspaceFolders(workspaceFolders.length, 0, {
  uri: externalFolderUri,
  name: '临时检索目录'
});

// 2. 调用findFiles检索该目录下的文件
const searchPattern = new vscode.RelativePattern(externalFolderUri, '**/*.js');
const searchResult = await vscode.workspace.findFiles(searchPattern);

// 3. 检索完成后移除临时添加的目录
const updatedFolders = vscode.workspace.workspaceFolders ?? [];
const tempFolderIndex = updatedFolders.findIndex(folder => folder.uri.fsPath === externalFolderUri.fsPath);
if (tempFolderIndex > -1) {
  vscode.workspace.updateWorkspaceFolders(tempFolderIndex, 1);
}

注意：该方案会触发工作区变更事件，用户会在侧边栏资源管理器看到临时目录的新增和移除过程，仅适合内部工具类扩展使用。

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