# Path Editor (系统环境变量编辑器)

* Path Editor 是一个专为 Windows 用户设计的系统环境变量（PATH）管理工具。它基于原生 C 语言和 IUP 图形库开发，旨在替代 Windows 自带的简陋编辑界面。
* 相比系统自带的编辑器，Path Editor 提供了更加直观的双视图（系统/用户变量）界面、智能的路径有效性检测、自动备份机制以及便捷的拖拽操作，让环境变量的管理变得安全、高效且轻松。无论您是开发者还是系统管理员，它都是您配置开发环境的得力助手。

## ✨ 功能特点

* **🛡️ 安全第一**：
  * **自动备份**：每次保存前自动备份注册表，防止意外。
  * **只读模式**：非管理员运行时自动切换到只读模式，防止误操作。
  * **权限检测**：智能检测当前运行权限。

* **📑 双视图与预览**：
  * **分离管理**：完美支持 **System (系统变量)** 和 **User (用户变量)** 的分离查看与编辑。
  * **合并预览**：新增标签页，展示最终解析后的完整 PATH 顺序（系统在前，用户在后），方便排查冲突。
  * **变量展开**：鼠标悬停在包含变量（如 `%JAVA_HOME%`）的路径上时，自动显示解析后的绝对路径。

* **🔴 智能诊断与维护**：
  * **无效路径高亮**：自动检测路径是否存在，不存在的显示为红色。
  * **重复路径高亮**：自动检测重复项，重复的显示为橙色。
  * **一键清理**：智能移除所有无效和重复的路径，保持环境整洁。

* **📂 高级交互**：
  * **多选支持**：支持使用 `Ctrl` 或 `Shift` 进行多选，批量删除或移动路径。
  * **撤销/重做**：支持 `Ctrl+Z` 撤销和 `Ctrl+Y` 重做，防止误操作，并提供直观的工具栏按钮。
  * **拖拽支持**：直接将文件夹拖入窗口即可添加（支持管理员模式下的 UIPI 穿透）。
  * **实时搜索**：顶部搜索框支持不区分大小写的实时过滤查找（支持快捷键 `Ctrl+F`）。
  * **全局快捷键**：支持 `Ctrl+N` 新建、`Ctrl+S` 保存、`Delete` 删除等快捷操作。

* **🎨 个性化**：
  * **深色模式**：一键切换深色主题，保护视力。

* **便捷管理**：
  * ➕ **新建**：添加新路径到列表。
  * 📂 **浏览**：直接从文件资源管理器选择目录添加。
  * ✏️ **编辑**：双击或点击按钮修改现有路径。
  * 🗑️ **删除**：移除不需要的路径。
  * ⬆️⬇️ **排序**：上移/下移调整路径优先级。
  * 📥/📤 **导入导出**：支持将环境变量导出为 `.txt` 文本文件备份，或从文件导入恢复。

* **轻量级**：原生 C 语言编写，无臃肿依赖，运行速度极快。

## 🏗️ 架构与二次开发

本项目注重代码的模块化和可维护性，非常适合作为 C 语言桌面程序开发的参考：

* **统一配置中心**：所有的 UI 尺寸、间距、颜色等常量配置均提取在 `include/config.h` 中，只需修改宏定义即可轻松定制属于你的专属界面风格。
* **清晰的全局状态**：全局变量和常量被独立分离在 `src/globals.c` / `include/globals.h` 中管理，使得核心业务逻辑更加整洁。

## 📦 下载与安装

您可以从 [Releases](https://github.com/LHY0125/PathEditor/releases) 页面下载最新的安装包 (`PathEditorSetup.exe`)。

安装完成后，请**以管理员身份运行**程序以确保能够保存对系统环境变量的修改。

## 🛠️ 构建指南

如果您想从源码构建本项目，请按照以下步骤操作：

### 环境要求

* Windows 操作系统
* GCC 编译器 (推荐 MinGW-w64)
* Make 工具
* IUP 库 (已包含在 `libs` 目录下)
* Inno Setup 6 (仅打包需要)

### 编译步骤

1. 克隆仓库：

   ```bash
   git clone https://github.com/LHY0125/PathEditor.git
   cd PathEditor
   ```

2. 编译项目：

   ```bash
   mingw32-make
   ```

3. 运行：
   编译成功后，可执行文件位于 `bin/PathEditor.exe`。

### 打包 (可选)

本项目使用 Inno Setup 生成安装包。

1. 确保已安装 [Inno Setup 6](https://jrsoftware.org/isdl.php)。
2. 运行根目录下的 `build_installer.bat` 脚本。
3. 生成的安装包将位于 `dist/dist/PathEditorSetup.exe`。

## 📝 使用说明

1. **启动**：右键点击程序图标，选择“以管理员身份运行”。
2. **查看**：程序启动后会自动加载当前的系统 PATH 变量。
   * **红色**条目表示路径不存在。
   * **橙色**条目表示路径重复。
   * **变量预览**：鼠标悬停在带 `%` 的变量上可查看实际路径。
3. **搜索**：在顶部输入关键词或按 `Ctrl+F` 可快速筛选。
4. **修改**：
   * **拖拽**：将文件夹拖入列表可直接添加。
   * **多选**：按住 `Ctrl` 或 `Shift` 可选中多项进行批量删除。
   * **撤销/重做**：误操作时可使用 `Ctrl+Z` / `Ctrl+Y` 或工具栏按钮回退。
   * **常规操作**：使用右侧按钮栏进行新建、编辑、移动等操作。
   * **清理**：点击“一键清理”可自动删除无效和重复项。
   * **导入/导出**：使用导入导出功能备份或恢复配置。
5. **保存**：操作完成后，务必点击底部的【确定】按钮（或按 `Ctrl+S`）保存更改。
6. **生效**：保存后，某些正在运行的程序可能需要重启才能识别新的环境变量。CMD 或 PowerShell 窗口需要重新打开。

## 👤 作者信息

* **作者**：LHY
* **邮箱**：<3364451258@qq.com>
* **GitHub**：[https://github.com/LHY0125/PathEditor](https://github.com/LHY0125/PathEditor)

如果您觉得这个工具对您有帮助，请给我的 GitHub 仓库点个 Star ⭐️！

## 📄 许可证

本项目基于 MIT 许可证开源，您可以在遵守许可证条款的前提下自由使用、修改和分发本项目的代码。

详细信息请参阅 [LICENSE](LICENSE) 文件。

Copyright © 2026 LHY. All Rights Reserved.