Eclipse插件中Clang工具输出延迟及焦点丢失问题求助

我之前做过类似的Eclipse C/C++插件开发，碰到过几乎一样的坑，给你针对性地解决这两个问题：

一、解决输出延迟问题 #

这个延迟本质是没有正确触发Eclipse的UI/资源刷新机制——你的检查结果已经出来了，但Eclipse不知道要更新界面。

• 用Eclipse标准的IMarker标记机制替代手动输出：
  别自己用Display打印错误，Eclipse的编辑器标记系统（gutter上的提示点、hover信息）是通过IMarker实现的。每次检查完成后，先清除旧标记，再添加新标记，最后通知编辑器刷新：

  // 获取当前编辑的文件资源
  IFile file = (IFile) PlatformUI.getWorkbench().getActiveWorkbenchWindow()
          .getActivePage().getActiveEditor().getEditorInput().getAdapter(IFile.class);
  if (file == null) return;
  
  // 清除该文件下的旧检查标记
  file.deleteMarkers("ccchecker.missing.break", true, IResource.DEPTH_ZERO);
  
  // 解析Clang工具输出的错误，逐个添加新标记
  for (String error : errorMessages) {
      IMarker marker = file.createMarker("ccchecker.missing.break");
      marker.setAttribute(IMarker.MESSAGE, error);
      marker.setAttribute(IMarker.SEVERITY, IMarker.SEVERITY_ERROR);
      // 如果能定位到行号，设置行号属性
      marker.setAttribute(IMarker.LINE_NUMBER, lineNumber);
  }
  
  // 异步触发编辑器刷新，确保UI即时更新
  Display.getDefault().asyncExec(() -> {
      IEditorPart editor = PlatformUI.getWorkbench().getActiveWorkbenchWindow()
              .getActivePage().getActiveEditor();
      if (editor != null) {
          editor.refresh();
      }
  });
  

• 调整检查触发时机：
  如果是实时检查（编辑时），别每输入一个字符就触发Clang工具，会导致性能问题。注册ITextListener监听编辑器文本变更，加个500ms的延迟（用Timer或ScheduledExecutorService）再执行检查，避免频繁调用。如果是保存时触发，监听IResourceChangeListener的POST_CHANGE事件，确保文件保存完成后立即执行检查。

二、解决焦点丢失与自定义控制台问题 #

1. 避免编辑器焦点丢失 #

当你创建自定义控制台时，Eclipse默认会激活Console View导致焦点转移。解决方法是只添加控制台到管理器，不主动激活它：

// 创建自定义控制台
MessageConsole cccConsole = new MessageConsole("CCChecker Console", null);
ConsolePlugin.getDefault().getConsoleManager().addConsoles(new IConsole[]{cccConsole});

// 输出内容，但不激活控制台
MessageConsoleStream stream = cccConsole.newMessageStream();
stream.setColor(Display.getDefault().getSystemColor(SWT.COLOR_RED));
stream.println("Missing break statement in case X");
stream.close();

如果需要用户手动查看控制台，他们可以自己切换到Console View，不会强制抢走编辑器焦点。

2. 给自定义控制台添加标准按钮 #

默认的MessageConsole会自带清除、暂停等按钮，如果你的没有，大概率是没正确注册控制台。另外，要自定义按钮的话，可以通过IConsolePageParticipant实现：

• 先写一个控制台页面参与者类：

  public class CCCConsolePageParticipant implements IConsolePageParticipant {
      @Override
      public void init(IConsolePageParticipantSite site) {
          IToolBarManager toolBarManager = site.getActionBars().getToolBarManager();
          // 添加清除控制台按钮
          toolBarManager.add(new Action("Clear") {
              @Override
              public void run() {
                  ((MessageConsole) site.getConsole()).clearConsole();
              }
          });
          // 还可以添加其他按钮，比如导出日志等
      }
  
      // 实现其他必要方法
      @Override
      public Object getAdapter(Class adapter) {
          return null;
      }
  
      @Override
      public void dispose() {}
  
      @Override
      public void activated() {}
  
      @Override
      public void deactivated() {}
  }
  

• 然后在插件的plugin.xml中注册这个扩展：

  <extension point="org.eclipse.ui.console.consolePageParticipants">
      <consolePageParticipant
            class="ccchecker.console.CCCConsolePageParticipant"
            id="ccchecker.consolePageParticipant">
          <enablement>
              <instanceof value="org.eclipse.ui.console.MessageConsole"/>
              <test property="org.eclipse.ui.console.name" value="CCChecker Console"/>
          </enablement>
      </consolePageParticipant>
  </extension>
  

这样你的自定义控制台就会有标准按钮了。

额外小提示 #

调用Clang工具时，一定要单独开线程读取stdout和stderr，否则缓冲区满会导致进程阻塞，这也可能间接导致输出延迟：

Process clangProcess = processBuilder.start();

// 读取标准输出
new Thread(() -> {
    try (BufferedReader reader = new BufferedReader(new InputStreamReader(clangProcess.getInputStream()))) {
        String line;
        while ((line = reader.readLine()) != null) {
            // 解析输出内容，比如提取错误信息和行号
            String finalLine = line;
            Display.getDefault().asyncExec(() -> {
                // 更新标记或控制台输出
            });
        }
    } catch (IOException e) {
        e.printStackTrace();
    }
}).start();

// 读取错误输出同理
new Thread(() -> {
    try (BufferedReader reader = new BufferedReader(new InputStreamReader(clangProcess.getErrorStream()))) {
        String line;
        while ((line = reader.readLine()) != null) {
            // 处理错误信息
        }
    } catch (IOException e) {
        e.printStackTrace();
    }
}).start();

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