如何在Visual Studio Code自定义命令中正常调用fs.writeFileSync()写入文件

你遇到的问题并非fs写入被拦截，而是相对路径的工作目录不匹配：
直接用node运行test.js时，相对路径"test.txt"是相对于你执行node命令的终端工作目录，文件会生成在你预期的位置；但VS Code扩展运行时的默认工作目录是VS Code自身的程序目录，文件实际已经写入成功，只是存储到了你没有预期的系统路径下，所以才找不到文件也没有报错。

你需要先拼接得到目标路径的绝对路径，再调用fs写入即可，根据你的使用场景可以选择以下方案：

1. 写入到当前打开的工作区根目录 #

如果需要把文件放到用户当前打开的项目根目录，先通过VS Code API获取工作区路径：

const vscode = require('vscode');
const fs = require('fs');
const path = require('path');

function activate(context) {
    let disposable = vscode.commands.registerCommand('extension.test', async () => {
        vscode.window.showInformationMessage('Testing!');
        // 校验是否打开了工作区
        const workspaceFolders = vscode.workspace.workspaceFolders;
        if (!workspaceFolders) {
            vscode.window.showErrorMessage('请先打开一个工作区再执行操作');
            return;
        }
        // 拼接绝对路径
        const targetPath = path.join(workspaceFolders[0].uri.fsPath, 'test.txt');
        try {
            fs.writeFileSync(targetPath, "Test success!");
            vscode.window.showInformationMessage(`文件已生成到：${targetPath}`);
        } catch (error) {
            console.error(error);
            vscode.window.showErrorMessage(`写入失败：${error.message}`);
        }
    });
    context.subscriptions.push(disposable);
}

2. 写入到扩展专属存储目录 #

如果是存储扩展自身的配置、缓存类文件，使用VS Code提供的专属存储路径即可，不需要占用工作区空间：

// 全局存储路径，跨所有工作区生效
const storageRoot = context.globalStorageUri.fsPath;
// 如只需要存储到当前工作区专属路径，改用 context.storageUri.fsPath
const targetPath = path.join(storageRoot, 'test.txt');
fs.writeFileSync(targetPath, "Test success!");

3. 让用户自定义保存路径 #

如果需要用户自主选择保存位置，调用VS Code的保存对话框API即可：

const saveUri = await vscode.window.showSaveDialog({
    filters: {
        '文本文件': ['txt']
    },
    defaultUri: vscode.Uri.file('test.txt')
});
if (saveUri) {
    fs.writeFileSync(saveUri.fsPath, "Test success!");
}

• 操作工作区文件更推荐使用VS Code内置的vscode.workspace.fsAPI，比Node原生fs兼容性更好，支持远程开发、WSL、虚拟文件系统等场景，示例如下：

await vscode.workspace.fs.writeFile(
    vscode.Uri.file(targetPath),
    Buffer.from("Test success!")
);

• 排查路径问题时，可以打印拼接后的绝对路径，在VS Code顶部菜单栏选择「帮助」→「切换开发人员工具」，在控制台中即可看到输出的路径，直接访问对应位置就能验证文件是否生成。

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