构建Visual Studio扩展编辑器-保存时突然(VS 16.8+)“bufferAdapter不是VsTextDocData”

基础概念

Visual Studio 扩展编辑器是一个允许开发者自定义 Visual Studio IDE 的工具。通过编写扩展，开发者可以添加新的功能、修改现有功能或改变 IDE 的外观。VsTextDocData 是 Visual Studio 中的一个接口，用于表示文本文档的数据。

问题描述

在 Visual Studio 16.8 及以上版本中，保存时出现“bufferAdapter不是VsTextDocData”的错误，通常是由于扩展代码中对 VsTextDocData 接口的不正确处理引起的。

原因分析

1. 接口变更：Visual Studio 的更新可能导致某些接口发生变化，VsTextDocData 接口可能在 16.8 版本中有所改变。
2. 代码兼容性：扩展代码可能没有适配最新的 Visual Studio 版本，导致在保存时出现错误。
3. 初始化问题：bufferAdapter 可能没有正确初始化为 VsTextDocData 的实例。

解决方法

1. 检查接口变更

首先，查看 Visual Studio 16.8 的更新日志，确认 VsTextDocData 接口是否有变更。可以参考以下链接：

Visual Studio 16.8 更新日志

2. 更新扩展代码

根据更新日志中的信息，修改扩展代码以适配新的接口。以下是一个示例代码片段，展示如何正确初始化 bufferAdapter：

using Microsoft.VisualStudio.TextManager.Interop;

public class MyEditorExtension
{
    private IVsTextBufferAdapter bufferAdapter;

    public MyEditorExtension()
    {
        // 初始化 bufferAdapter
        bufferAdapter = (IVsTextBufferAdapter)System.Runtime.InteropServices.Marshal.GetTypedObjectForIUnknown(
            System.Runtime.InteropServices.Marshal.GetIUnknownForObject(new VsTextDocDataImpl()),
            typeof(IVsTextBufferAdapter));
    }

    // 其他代码...
}

public class VsTextDocDataImpl : IVsTextDocData
{
    // 实现 IVsTextDocData 接口的方法...
}

3. 调试和测试

在修改代码后，重新编译并运行扩展，确保在保存时不再出现错误。可以使用 Visual Studio 的调试工具来跟踪和解决潜在的问题。

应用场景

这种问题通常出现在开发 Visual Studio 扩展的过程中，特别是在更新 Visual Studio 版本后，需要确保扩展与新版本的兼容性。

参考链接

• Visual Studio 扩展开发文档
• IVsTextDocData 接口文档

通过以上步骤，你应该能够解决“bufferAdapter不是VsTextDocData”的问题，并确保你的 Visual Studio 扩展在新版本中正常工作。