VS Code中vscode.workspace.onDidChangeTextDocument无变更也触发，如何正确监听保存事件

判定方式的正确性说明 #

你通过vscode.workspace.onDidChangeTextDocument()事件的changeEvent.document.isDirty === false判定文档保存完成的逻辑是成立的，但不属于最优实现方案，单独使用该条件确实会遇到你所说的冗余触发问题。

冗余触发的常见原因 #

你观察到的无实际变更的第四类事件，属于VS Code API的正常触发逻辑，常见触发场景如下：

• VS Code内部元数据更新：文件编码、换行符格式、语言识别模式等文档属性变更，哪怕内容没有修改，也会触发该事件，此时contentChanges长度为0，也没有实际的内容变更。
• 保存操作的多步内部逻辑：VS Code执行保存时会分为两步：先把内容写入磁盘，再同步文件系统状态、更新文档最后修改时间等元信息，两个步骤会分别触发一次事件，第二次就是无内容变更的冗余触发，会和保存完成事件同步出现。
• 其他插件的联动操作：如果安装的其他插件在保存时执行了无内容修改的操作（比如格式化但无实际改动、仅修改文件系统属性等），也会触发额外的空变更事件。

推荐实现方案 #

如果你只需要捕获用户修改文件内容且完成保存的事件，更推荐直接使用VS Code原生的vscode.workspace.onDidSaveTextDocument() API，该API仅会在文档实际完成保存操作时触发，不会出现空变更的冗余回调。

如果必须基于onDidChangeTextDocument实现，可以增加两层过滤逻辑排除冗余事件：

// 维护Map记录文件的历史脏状态
const documentDirtyMap = new Map();

const changeTextDocumentListener = vscode.workspace.onDidChangeTextDocument(event => {
    const docUri = event.document.uri.toString();
    // 第一步：直接过滤无内容变更的事件
    if (event.contentChanges.length === 0) {
        return;
    }
    // 记录文档进入脏状态
    if (event.document.isDirty) {
        documentDirtyMap.set(docUri, true);
        return;
    }
    // 第二步：仅当文档之前为脏状态、当前变为非脏状态时，判定为修改后保存完成
    if (documentDirtyMap.get(docUri)) {
        documentDirtyMap.delete(docUri);
        // 此处编写保存完成后的业务逻辑
        console.log('文档修改后保存完成：', event.document.fileName);
    }
});

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