Skip to content

caolib/env-manager

Repository files navigation

Windows 环境变量管理器 - uTools 插件

一个方便的 Windows 环境变量管理 uTools 插件,提供图形化界面来管理系统和用户环境变量。

功能特性

核心功能

  • 环境变量管理:查看、添加、编辑、删除系统和用户环境变量
  • Path 变量特殊支持:对 Path 变量提供分行显示和编辑功能
  • 搜索过滤:支持按变量名、变量值或全部搜索
  • 权限检测:自动检测是否有管理员权限,提示用户相关限制
  • 导入导出:支持环境变量配置的导出和导入,便于备份和迁移

界面特色

  • 🎨 主题支持:支持浅色、深色和跟随系统主题
  • 🔍 关键词高亮:搜索结果中高亮显示匹配的关键词
  • 📋 KV 快捷输入:支持 KEY=VALUE 格式快速输入环境变量
  • 🎯 分类展示:系统环境变量和用户环境变量分开显示

配置选项

  • 📁 默认导出路径:可设置环境变量备份的默认导出位置
  • 🚀 自动打开文件夹:导出后可自动在资源管理器中显示文件
  • 💾 配置持久化:所有设置自动保存到 uTools 数据库

快速开始

安装

  1. 克隆本仓库
  2. 安装依赖:
pnpm install

开发

pnpm dev

构建

pnpm build

使用

  1. 在 uTools 中安装插件
  2. 输入关键词:环境变量envenvironment
  3. 开始管理你的环境变量!

使用说明

基本操作

  • 查看变量:展开系统或用户环境变量面板查看所有变量
  • 搜索变量:使用顶部搜索框,可选择搜索类型(全部/变量名/变量值)
  • 添加变量:点击对应面板的"添加"按钮
  • 编辑变量:点击变量卡片的"编辑"按钮
  • 删除变量:点击变量卡片的"删除"按钮,需确认

Path 变量编辑

对于包含分号分隔的 Path 变量,插件提供了更友好的编辑方式:

  • 自动按行显示各个路径
  • 可以逐行编辑、删除
  • 支持添加新路径

导入导出

  • 导出:点击"配置"菜单 → "导出配置",保存当前所有环境变量
  • 导入:点击"配置"菜单 → "导入配置",从备份文件恢复环境变量

注意事项

⚠️ 重要提示

  1. 修改系统环境变量需要管理员权限
  2. 用户环境变量无需管理员权限即可修改
  3. 修改环境变量后,新打开的程序才会生效
  4. 建议在修改前先导出备份
  5. 删除环境变量时请谨慎操作

技术栈

  • 框架:Vue 3 + Composition API
  • UI 库:Ant Design Vue
  • 构建工具:Vite
  • 运行环境:uTools + Node.js preload
  • 状态管理:Pinia(使用 uTools dbStorage)

项目结构

env-manager/
├── public/
│   ├── plugin.json          # uTools 插件配置
│   └── preload/
│       └── services.js      # Node.js 预加载脚本(环境变量操作)
├── src/
│   ├── components/
│   │   ├── EnvVarCard.vue   # 环境变量卡片组件
│   │   ├── HomeView.vue     # 主页面(环境变量管理)
│   │   └── ConfigView.vue   # 配置页面
│   ├── stores/
│   │   └── settings.js      # 设置状态管理
│   ├── utils/
│   │   └── store.js         # uTools dbStorage 封装
│   ├── App.vue              # 根组件
│   └── main.js              # 入口文件
└── README.md

贡献

欢迎提交 Issue 和 Pull Request!

许可证

MIT License

免责声明

本工具涉及系统环境变量的修改,使用时请谨慎操作。作者不对因使用本工具造成的任何系统问题负责。建议在使用前先导出备份。

About

一个环境变量管理工具

Resources

Stars

Watchers

Forks

Packages

No packages published