vscode.workspace.fs 提供跨平台文件操作,支持异步读写、复制移动、目录创建与遍历、存在性检查及文件监听,适用于本地与远程开发场景。

在 VSCode 插件开发中,文件操作是核心功能之一。虽然 Node.js 的 fs 模块已经足够强大,但 VSCode 提供了更现代化、更安全的高级文件系统 API —— vscode.workspace.fs,它基于 Language Server Protocol(LSP)设计,支持跨工作区、远程开发(如 SSH、WSL、Containers)等复杂场景。
VSCode 从 1.36 版本开始引入 vscode.workspace.fs,作为对底层文件系统的统一抽象。相比传统的 fs 模块,它具备以下优势:
以下是一些常用文件操作的代码示例,展示如何在插件中使用该 API。
使用 readFile 方法读取文件,返回的是 Uint8Array,需要手动转为字符串。
const uri = vscode.Uri.file('/path/to/file.txt');
try {
const data = await vscode.workspace.fs.readFile(uri);
const text = new TextDecoder('utf-8').decode(data);
console.log(text);
} catch (err) {
console.error('读取失败:', err);
}
使用 writeFile 写入数据,同样接收 Uint8Array。
const uri = vscode.Uri.file('/path/to/hello.txt');
const text = 'Hello from VSCode API!';
const data = new TextEncoder().encode(text);
await vscode.workspace.fs.writeFile(uri, data);
注意:writeFile 会自动创建不存在的文件和目录。
ERMEB云盘发卡系统官方正版系统发卡系统操作简单、方便、易懂,系统微信小程序前端采用nuiapp、后端采用think PHP6,PC前端采用vue开发,使用场景:文件上传储存。适合个人/个体/中小企业使用,本系统配合微信小程序端进行使用,文件下载以及发卡商品卡密领取都需要进入小程序内获取下载码以及卡密领取,小程序内可设置积分充值以及任务获取积分,支持微信激励广告领取文件下载码以及卡密商品,可实现
0
支持跨文件系统操作,比如从本地复制到 WSL 环境。
const source = vscode.Uri.file('/tmp/old.txt');
const destination = vscode.Uri.file('/tmp/new.txt');
// 复制文件
await vscode.workspace.fs.copy(source, destination);
// 移动(重命名)
await vscode.workspace.fs.rename(source, destination, { overwrite: true });
创建目录使用 createDirectory,遍历用 readDirectory。
const dirUri = vscode.Uri.file('/tmp/my-folder');
await vscode.workspace.fs.createDirectory(dirUri);
// 遍历目录
const entries = await vscode.workspace.fs.readDirectory(dirUri);
for (const [name, type] of entries) {
if (type === vscode.FileType.File) {
console.log('文件:', name);
} else if (type === vscode.FileType.Directory) {
console.log('目录:', name);
}
}
虽然没有 exists 方法,但可以通过 try/catch 调用 stat 实现。
async function fileExists(uri) {
try {
await vscode.workspace.fs.stat(uri);
return true;
} catch {
return false;
}
}
const uri = vscode.Uri.file('/tmp/test.txt');
if (await fileExists(uri)) {
console.log('文件存在');
}
如果需要响应式处理文件变更,可以结合 vscode.workspace.createFileSystemWatcher。
const watcher = vscode.workspace.createFileSystemWatcher('**/*.txt');
watcher.onDidChange(uri => {
console.log('文件被修改:', uri.path);
});
以上就是VSCode文件操作_高级文件系统API使用实战的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号