更新记录

1.0.0（2026-06-24） 下载此版本

1.0.0（2026-06-22） Android 首版发布

悬浮 consola 按钮 + 可配置高度日志面板（默认 80% 屏高） 采集 console.log / info / warn / error 与 uni.log 捕获 App.onError、Vue 渲染错误、setTimeout 异步异常 崩溃前日志写入本地，下次启动自动恢复并展开面板 面板支持日志筛选、单条复制、清空、半透明遮罩点击关闭 标准 Android 基座即可调试，无需额外原生依赖

平台兼容性

uni-app(3.8.0)

Consola | uni-app 开发调试面板

面向 uni-app App 端的开发调试插件，模仿 vConsole 风格的悬浮日志面板，实时采集 console 输出与 JS 异常，便于日常开发与问题排查。

当前版本：仅 Android 可用。iOS / HarmonyOS 即将更新。

环境要求

• uni-app（vue / nvue）
• Android App 标准基座（无需自定义基座）
• 不支持 H5、小程序、CLI 独立集成

使用

1. 从插件市场导入，或将本插件目录放到项目的 uni_modules/下；
2. 按下方步骤修改 App.vue 与 main.js

App.vue

import * as Consola from "@/uni_modules/wg-app-consola";
import {
    initConsola,
    onConsolaAppError,
} from "@/uni_modules/wg-app-consola/addInterceptor/index.ts";

export default {
    onLaunch() {
        initConsola(Consola); // 放在第一行，方便收集到更多日志
        ...
    },
    onError: onConsolaAppError, // js 异常日志收集
};

main.js（Vue3，捕获渲染错误）

import * as Consola from "@/uni_modules/wg-app-consola";
import { bindConsolaVueApp } from "@/uni_modules/wg-app-consola/addInterceptor/index.ts";

export function createApp() {
    const app = createSSRApp(App);
    bindConsolaVueApp(app, Consola);
    return { app };
}

main.js（Vue2，捕获渲染错误）

在 new Vue() 之前调用 bindConsolaVue2：

import Vue from "vue";
import App from "./App";
import * as Consola from "@/uni_modules/wg-app-consola";
import { bindConsolaVue2 } from "@/uni_modules/wg-app-consola/addInterceptor/index.ts";

Vue.config.productionTip = false;
bindConsolaVue2(Vue, Consola);

App.mpType = "app";
const app = new Vue({
    ...App,
});
app.$mount();

面板配置

initConsola(Consola, {
    panelHeightRatio: 0.5, // 半屏面板
    crashLogLimit: 300, // 崩溃时多保留一些日志
});