VS2022自定义.clf语言IntelliSense扩展符号加载及补全故障排查

• 确认内容类型注册正确性
  检查内容类型的导出配置，确保.clf文件的扩展名映射在ProvideFileExtensionMapping属性中正确设置，且内容类型的GUID在所有相关类中保持唯一且一致。

• 验证MEF导出属性配置
  确保ICompletionSourceProvider和IVsTextViewCreationListener的导出属性包含正确的ContentType元数据，示例如下：

  [Export(typeof(ICompletionSourceProvider))]
  [ContentType("YourCustomContentType")]
  [Name("CustomCompletionProvider")]
  public class CustomCompletionSourceProvider : ICompletionSourceProvider { ... }
  

  同时检查IVsTextViewCreationListener的导出是否关联正确的内容类型和可编辑TextView角色：

  [Export(typeof(IVsTextViewCreationListener))]
  [ContentType("YourCustomContentType")]
  [TextViewRole(PredefinedTextViewRoles.Editable)]
  public class TextViewCreationListener : IVsTextViewCreationListener { ... }
  

• 检查命令目标附加逻辑
  在IVsTextViewCreationListener的VsTextViewCreated方法中，确认已正确将自定义IOleCommandTarget附加到TextView的命令链，且未中断原有命令处理流程：

  public void VsTextViewCreated(IVsTextView textViewAdapter)
  {
      var textView = textViewAdapter as IVsUserData;
      if (textView == null) return;
  
      object obj;
      textView.GetData(typeof(IVsTextView).GUID, out obj);
      var wpfTextView = obj as IWpfTextView;
      if (wpfTextView == null) return;
  
      var commandTarget = new CustomCommandTarget(textViewAdapter, wpfTextView);
      textViewAdapter.AddCommandFilter(commandTarget, out _);
  }
  

• 确认ICompletionSource实现逻辑
  在ICompletionSource的AugmentCompletionSession方法中，确保已将静态字符串正确添加到completionSet.Completions集合，无过早返回或过滤所有项的情况：

  public void AugmentCompletionSession(ICompletionSession session, IList<CompletionSet> completionSets)
  {
      var completions = new List<Completion>
      {
          new Completion("StaticItem1", "StaticItem1", "Item 1 description", null, null),
          new Completion("StaticItem2", "StaticItem2", "Item 2 description", null, null)
      };
  
      var completionSet = new CompletionSet(
          "Custom",
          "Custom",
          session.TextView.Caret.Position.BufferPosition,
          completions,
          null);
  
      completionSets.Add(completionSet);
  }
  

• 检查调试配置
  确认调试时选择"启动外部程序"并指向devenv.exe，同时勾选"使用UI线程调试"，避免调试环境导致扩展未正确加载。

• 验证扩展加载状态
  通过VS的"扩展管理"确认自定义扩展已启用；或启动devenv.exe时添加/log参数，查看%APPDATA%\Microsoft\VisualStudio\<版本>\ActivityLog.xml日志，排查是否存在扩展加载失败的错误信息。

• 检查内容类型优先级
  确认自定义内容类型未被其他扩展覆盖，可通过"选项->文本编辑器->文件扩展名"查看.clf对应的编辑器是否为自定义编辑器，避免扩展名关联被抢占。

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