IntelliJ Idea插件安装后System.err.println无法输出至控制台问题求助

阿华AIGC实验室

2026-4-29

解决IntelliJ插件打包后System.err无法输出到控制台的问题

我之前开发IntelliJ插件时也碰到过一模一样的情况！开发阶段在Run/Debug模式下System.err能正常输出到开发控制台，但打包安装后就只能在IDE日志里找到内容，当时折腾了好一会儿才搞清楚原因。

问题根源

IntelliJ平台在正式运行插件时，会把JVM的System.err和System.out流重定向到IDE的内部日志系统，而不是你操作时看到的控制台（比如Run窗口、自定义工具窗口）。开发阶段能看到是因为调试模式下IDE会把这些流转发到开发环境的Run控制台，这是调试时的特殊处理。

解决方案

1. 改用IntelliJ官方日志API（推荐）

这是IntelliJ插件开发的标准做法，不仅能让日志正确输出到IDE日志，还支持日志级别控制、类名溯源等功能。示例代码：

import com.intellij.openapi.diagnostic.Logger;

public class JsonCheckPlugin {
    // 初始化Logger，关联当前类
    private static final Logger LOG = Logger.getInstance(JsonCheckPlugin.class);

    public void checkJsonFiles() {
        // 代替System.err.println("JSON检查错误：xxx");
        LOG.error("JSON检查错误：xxx");
        
        // 根据场景选择不同级别
        LOG.warn("JSON格式不规范：xxx");
        LOG.info("JSON检查完成");
    }
}

日志会出现在IDE的Help > Show Log in Explorer对应的日志文件中，同时如果需要让用户直观看到错误，建议搭配IDE的通知弹窗：

import com.intellij.notification.NotificationGroupManager;
import com.intellij.notification.NotificationType;

// 在错误发生时弹出通知
NotificationGroupManager.getInstance()
    .getNotificationGroup("JSON Check Plugin Notifications")
    .createNotification("JSON检查错误：xxx", NotificationType.ERROR)
    .notify(project);

2. 输出到自定义插件控制台（如果需要用户可见的控制台）

如果你的插件有自己的工具窗口控制台，想要把错误输出到那里，需要使用IntelliJ的ConsoleView API：

import com.intellij.execution.ui.ConsoleView;
import com.intellij.execution.ui.ConsoleViewContentType;
import com.intellij.openapi.project.Project;
import com.intellij.openapi.wm.ToolWindow;
import com.intellij.openapi.wm.ToolWindowManager;

public class PluginConsoleHelper {
    public void printErrorToConsole(Project project, String errorMsg) {
        // 获取预先在plugin.xml中配置的工具窗口
        ToolWindow toolWindow = ToolWindowManager.getInstance(project).getToolWindow("JSON Check Console");
        if (toolWindow != null) {
            // 获取控制台组件（需确保工具窗口已初始化ConsoleView）
            ConsoleView consoleView = (ConsoleView) toolWindow.getContentManager().getContent(0).getComponent();
            // 输出错误内容，指定错误样式
            consoleView.print(errorMsg + "\n", ConsoleViewContentType.ERROR_OUTPUT);
        }
    }
}

注意：需要先在plugin.xml中配置工具窗口，并且初始化时创建ConsoleView实例。