VS Code扩展中如何保存非活动TextDocument且不触发格式化？

问题背景 #

• VS Code的TextDocument类型自带save()方法，正常保存时若开启了自动格式化，会先执行格式化操作再保存文档。
• 已知workbench.action.files.saveWithoutFormatting命令可通过编程方式调用，实现对活动文本编辑器关联文档的无格式化保存，但该命令无法作用于非活动编辑器关联的文档。

解决方案 #

目前VS Code API并未提供直接针对任意TextDocument的无格式化保存方法，但可以通过以下两种方案实现需求：

1. 临时禁用自动格式化，保存后恢复

先获取当前工作区的editor.formatOnSave配置，临时将其设为false，调用TextDocument.save()后再恢复原配置：

import * as vscode from 'vscode';

async function saveWithoutFormatting(doc: vscode.TextDocument): Promise<boolean> {
    const config = vscode.workspace.getConfiguration('editor', doc.uri);
    const originalFormatOnSave = config.get<boolean>('formatOnSave');
    
    try {
        await config.update('formatOnSave', false, vscode.ConfigurationTarget.Workspace);
        return await doc.save();
    } finally {
        // 恢复原配置，避免影响其他操作
        if (originalFormatOnSave !== undefined) {
            await config.update('formatOnSave', originalFormatOnSave, vscode.ConfigurationTarget.Workspace);
        }
    }
}

注意：该方式会短暂修改工作区配置，建议在操作前后做好状态隔离，避免干扰其他用户或进程的操作。

2. 直接写入磁盘绕过API保存逻辑

通过Node.js文件系统API直接将TextDocument内容写入对应文件路径，完全绕开VS Code的保存格式化逻辑，之后再同步文档脏状态：

import * as vscode from 'vscode';
import * as fs from 'fs/promises';

async function saveWithoutFormatting(doc: vscode.TextDocument): Promise<void> {
    if (doc.isDirty) {
        // 直接写入文件
        await fs.writeFile(doc.uri.fsPath, doc.getText());
        // 通知VS Code同步文档状态，清除脏标记
        await doc.save();
    }
}

注意：该方式仅适用于本地文件URI，需确保文件路径可写入，同时处理好文档状态同步，避免出现磁盘与编辑器内容不一致的情况。

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