IntelliJ IDEA插件开发：自定义IntentionAction无法显示进度条

看起来你已经抓到了关键差异：IntentionAction的执行上下文和AnAction完全不同，直接把AnAction里的进度条代码搬过来不生效，核心原因是IntentionAction的invoke方法默认在**事件调度线程（EDT）**同步执行——如果在这个方法里直接做耗时操作+进度条逻辑，会彻底阻塞UI线程，导致进度条根本来不及渲染。而AnAction的actionPerformed如果正确处理了后台线程，就能正常显示进度条。

下面是具体的解决方案和代码示例：

核心原理 #

IntelliJ平台的UI线程（EDT）不能被阻塞，任何耗时操作都必须放到后台线程执行。进度条的显示依赖于EDT能及时更新UI，所以必须通过ProgressManager来协调后台任务和进度UI的更新。

正确的IntentionAction实现示例 #

import com.intellij.codeInsight.intention.IntentionAction;
import com.intellij.openapi.progress.BackgroundableTask;
import com.intellij.openapi.progress.ProgressIndicator;
import com.intellij.openapi.progress.ProgressManager;
import com.intellij.openapi.project.Project;
import com.intellij.psi.PsiFile;
import com.intellij.openapi.editor.Editor;
import org.jetbrains.annotations.NotNull;

public class ProgressIntentionAction implements IntentionAction {

    @NotNull
    @Override
    public String getText() {
        return "执行带进度条的修复操作";
    }

    @NotNull
    @Override
    public String getFamilyName() {
        return getText();
    }

    @Override
    public boolean isAvailable(@NotNull Project project, Editor editor, PsiFile file) {
        // 根据你的业务逻辑判断该Intention是否可用
        return true;
    }

    @Override
    public void invoke(@NotNull Project project, Editor editor, @NotNull PsiFile file) {
        // 使用BackgroundableTask在后台执行任务，同时显示进度条
        ProgressManager.getInstance().run(new BackgroundableTask(project, "正在处理任务", false) {
            @Override
            public void run(@NotNull ProgressIndicator indicator) {
                // 这里是后台线程，执行你的耗时操作
                indicator.setIndeterminate(false); // 设置为确定进度（如果能计算进度）
                int totalSteps = 100;

                for (int i = 0; i < totalSteps; i++) {
                    // 检查用户是否取消了任务
                    indicator.checkCanceled();
                    // 更新进度比例和提示文本
                    indicator.setFraction((double) i / totalSteps);
                    indicator.setText("正在执行第 " + (i + 1) + " 步");

                    // 模拟耗时操作（替换成你的实际业务代码）
                    try {
                        Thread.sleep(50);
                    } catch (InterruptedException e) {
                        Thread.currentThread().interrupt();
                        break;
                    }
                }
            }
        });
    }

    @Override
    public boolean startInWriteAction() {
        // 如果你的操作不需要修改Psi元素，设为false；如果需要，设为true
        return false;
    }
}

关键注意点 #

• 绝对不要阻塞EDT：不要在invoke方法的主线程（EDT）里执行耗时操作，所有需要时间的逻辑都要放到BackgroundableTask的run方法中（这个方法会在后台线程执行）。
• 进度条类型选择：
  • 如果你无法计算具体进度，把indicator.setIndeterminate(true)，显示转圈的加载动画。
  • 如果能计算进度，用setIndeterminate(false)配合setFraction()显示百分比进度。
• 响应取消操作：定期调用indicator.checkCanceled()，如果用户点击了取消按钮，这个方法会抛出ProcessCanceledException，终止任务。
• 模态/非模态进度条：BackgroundableTask的第三个参数设为true会显示模态进度条（阻塞用户操作直到任务完成），设为false则是非模态的（用户可以继续操作其他部分）。

对比AnAction的差异 #

你的HelloAction能显示进度条，应该是因为你在actionPerformed里正确使用了ProgressManager把任务放到了后台线程。而IntentionAction默认的invoke方法是同步在EDT执行的，所以必须显式用ProgressManager来管理后台任务和进度UI。

内容的提问来源于stack exchange，提问作者Alexander Chebykin