Vite Console Plugin

🚀 一个精美的 Vite 开发服务器启动信息插件，提供企业级的终端输出体验

✨ 特性

• 🎨 精美的视觉效果 - 使用丰富的颜色和图标打造专业级启动界面
• 🔧 智能信息整合 - 自动获取版本号、Git 信息、服务器地址等开发信息
• 🚫 原生信息屏蔽 - 智能屏蔽 Vite 原生的杂乱输出，保留重要开发信息
• ⚡ 零配置使用 - 开箱即用，同时支持灵活的自定义配置
• 📦 自动版本读取 - 自动从 package.json 读取最新版本信息
• 🌿 Git 集成 - 显示当前分支状态、远程同步情况和提交哈希
• 🛡️ 团队协作 - 支持团队信息、警告提示等协作功能
• 🔄 配置重载提醒 - 配置文件更改时提供友好的重载提示

📦 安装

npm install vite-console-plugin --save-dev
# 或
yarn add vite-console-plugin -D
# 或
pnpm add vite-console-plugin -D

🚀 快速开始

基础使用

// vite.config.ts
import { defineConfig } from 'vite'
import viteConsolePlugin from 'vite-console-plugin'

export default defineConfig({
  plugins: [
    viteConsolePlugin({
      systemName: 'My App',
      description: '我的应用系统',
      owner: 'Your Name'
    })
  ]
})

完整配置

// vite.config.ts
import { defineConfig } from 'vite'
import viteConsolePlugin from 'vite-console-plugin'

export default defineConfig({
  plugins: [
    viteConsolePlugin({
      systemName: 'Robot_Admin',
      description: '后台管理系统',
      team: 'AGILE|TEAM',
      owner: 'CHENY',
      warning: '请勿随意修改配置文件',
      security: '禁止部署未加密的敏感数据',
      autoVersion: true,
      devtools: 'Vue DevTools & UnoCSS Inspector'
    })
  ]
})

📋 配置选项

| 选项 | 类型 | 默认值 | 描述 | |------|------|--------|------| | systemName | string | 'Robot_Admin' | 系统名称 | | description | string | '后台管理系统' | 系统描述 | | team | string | 'AGILE\|TEAM' | 团队名称 | | owner | string | 'CHENY' | 项目负责人 | | warning | string | '请勿随意修改配置文件' | 协作警告信息 | | security | string | '禁止部署未加密的敏感数据' | 安全警告信息 | | autoVersion | boolean | true | 是否自动读取 package.json 版本 | | devtools | string | '' | 开发工具提示，留空则不显示 |

🎨 输出效果

启动时的完整输出

──────────────────────────────────────────────────

🤖 Robot_Admin 后台管理系统

⚡ 服务器信息
   ● 本地访问   http://localhost:5173/
   ● 网络访问   http://192.168.1.100:5173/
   ● 开发工具   Vue DevTools & UnoCSS Inspector

📦 项目信息
   ● 版本号       v1.2.3
   ● 启动时间     2026-03-31 10:30:45
   ● Git 分支     main (与远程同步 ✅)
   ● 提交哈希     a1b2c3d

👥 团队信息
   ● 架构组       AGILE|TEAM
   ● 负责人       CHENY

⚠️  重要提醒
   ● 请勿随意修改配置文件
   ● 禁止部署未加密的敏感数据

✨ 启动成功！ 开发服务器已就绪
──────────────────────────────────────────────────

配置重载提示

⚡ 配置重载 配置文件已更改，请验证修改项并告知相关干系人

🔍 功能详解

自动信息获取

插件会自动获取以下信息：

• 版本号: 从 package.json 自动读取（基于 Vite root 路径解析，支持 monorepo）
• Git 分支: 获取当前分支及与远程分支的同步状态（领先/落后/分叉）
• Git 提交: 获取最新提交的短哈希
• 服务器地址: 优先使用 Vite 解析后的实际地址
• 启动时间: 服务器启动的具体时间（中文格式）

智能信息屏蔽

插件会智能屏蔽 Vite 原生的以下输出，但保留重要的开发信息：

屏蔽的信息：

• ➜ Local: http://localhost:xxxx/
• ➜ Network: use --host to expose
• ➜ Vue DevTools: Open http://...
• ➜ UnoCSS Inspector: http://...
• ➜ press h + enter to show help
• DevTools 相关的所有 URL 和快捷键提示

保留的重要信息：

• ready in Xms - 构建完成时间
• built in Xms - 构建耗时
• server restarted - 服务器重启
• hmr update - HMR 更新
• dependencies optimized - 依赖优化完成
• 所有错误和警告信息

兼容性

• ✅ Vite 4.0+
• ✅ Node.js 16+
• ✅ TypeScript 完整支持
• ✅ Windows / macOS / Linux
• ✅ 支持 pnpm / yarn / npm

📝 更新日志

v2.1.0

• 🔧 新增 devtools 配置项，不再硬编码开发工具信息
• 🐛 修复 Git commit 数 ≥10 时状态判断错误
• 🐛 修复 package.json 路径解析在 monorepo 下不准确的问题
• 🔒 使用 execFileSync 替代 execSync，消除 shell 注入风险
• ⚡ 优化服务器地址获取，优先使用 Vite resolvedUrls
• ♻️ 服务器关闭时自动恢复被劫持的 console 方法
• 🗑️ 移除循环自身依赖和未使用的代码
• 📦 exports 新增 TypeScript 类型入口

v1.0.0

• 🎉 初始版本发布
• ✨ 支持精美的启动界面显示
• 🔧 自动获取项目和Git信息
• 🚫 智能屏蔽原生杂乱输出
• 🎨 完整的颜色和图标系统
• ⚡ 配置重载友好提示

🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

👨‍💻 作者

CHENY - @ycyplus