# 环境变量管理器

**Repository Path**: cutecuteyu/environment-variable-manager

## Basic Information

- **Project Name**: 环境变量管理器
- **Description**: 环境变量管理器
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-10
- **Last Updated**: 2026-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 系统环境变量管理器

一个基于 Python tkinter 的 Windows 系统环境变量管理工具，可以方便地查看和编辑用户环境变量和系统环境变量。

## 功能特性

- ✅ 查看用户环境变量和系统环境变量
- ✅ 新建环境变量
- ✅ 编辑现有环境变量
- ✅ 删除环境变量
- ✅ 实时搜索过滤
- ✅ 自动通知系统环境变量变更
- ✅ 友好的图形界面

## 环境要求

- Python 3.13+
- UV 包管理器

## 使用方法

### 1. 初始化项目

项目已经使用 UV 初始化完成，包含以下文件：
- `pyproject.toml` - 项目配置文件
- `env_manager.py` - 主程序文件
- `README.md` - 说明文档

### 2. 运行程序

在 `env_manage` 文件夹中运行：

```bash
uv run python env_manager.py
```

### 3. 编译为可执行文件

使用 PyInstaller 将程序编译为独立的 Windows 可执行文件：

#### 步骤 1：安装 PyInstaller

```bash
uv add pyinstaller
```

#### 步骤 2：编译程序

```bash
uv run pyinstaller -F --uac-admin --noconsole env_manager.py
```

**编译参数说明**：
- `-F` 或 `--onefile`：打包为单个可执行文件
- `--uac-admin`：请求管理员权限运行（编辑系统环境变量需要）
- `--noconsole` 或 `-w`：不显示控制台窗口（仅 GUI 界面）

编译完成后，可执行文件位于 `dist/env_manager.exe`

### 4. 使用说明

程序启动后，您可以：

1. **选择变量类型**：在顶部选择"用户环境变量"或"系统环境变量"
2. **查看变量**：在列表中查看所有环境变量及其值
3. **搜索变量**：在搜索框中输入关键字进行过滤
4. **新建变量**：点击"新建变量"按钮创建新的环境变量
5. **编辑变量**：选中变量后点击"编辑变量"或双击变量进行编辑
6. **删除变量**：选中变量后点击"删除变量"按钮
7. **刷新列表**：点击"刷新"按钮重新加载环境变量

**注意**：编辑系统环境变量需要管理员权限。

## 技术说明

- 使用 `winreg` 模块访问 Windows 注册表
- 用户环境变量存储在：`HKEY_CURRENT_USER\Environment`
- 系统环境变量存储在：`HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment`
- 修改后自动通过 Windows 消息机制通知系统环境变量变更

## 注意事项

1. 修改系统环境变量需要管理员权限，请以管理员身份运行程序
2. 删除环境变量操作不可恢复，请谨慎操作
3. 某些程序可能需要重启才能生效新的环境变量设置
4. 建议在修改重要环境变量前先备份

## 许可证

MIT License