chore: 更新运行命令注释以反映最新的可执行文件路径

- 将原有扁平目录结构重构为 MVC 分层架构：
  * src/core/: 核心业务逻辑（Model），完全独立于 UI 框架
  * src/ui/: 界面组件构建（View），负责纯视觉展示
  * src/controller/: 用户交互处理（Controller），连接数据与界面
  * src/utils/: 底层工具函数，专注于系统调用和字符串处理
- 引入 AppContext 结构体统一管理应用状态，替代原有的全局变量模式
- 重命名并重新组织头文件，按功能模块划分到对应子目录
- 更新 CMakeLists.txt 以适配新的目录结构
- 同步更新 README.md 文档，说明新的架构设计

CMakeLists.txt

@@ -0,0 +1,80 @@
+cmake_minimum_required(VERSION 3.10)
+project(PathEditor VERSION 3.0 LANGUAGES C)
+
+# 启用资源编译器以处理 .rc 文件
+enable_language(RC)
+
+# 设置 C 标准
+set(CMAKE_C_STANDARD 17)
+set(CMAKE_C_STANDARD_REQUIRED ON)
+set(CMAKE_C_EXTENSIONS OFF) # 禁用特定编译器的扩展（如 gnu17），强制使用标准 C17
+
+# 定义源文件
+set(SOURCES
+    src/main.c
+    src/utils/string_ext.c
+    src/utils/os_env.c
+    src/ui/ui_utils.c
+    src/ui/dialogs.c
+    src/ui/main_window.c
+    src/core/registry_service.c
+    src/core/path_manager.c
+    src/core/app_context.c
+    src/controller/callbacks.c
+    ico/resources.rc
+)
+
+# 创建 GUI 可执行文件（WIN32 属性会自动添加 -mwindows 参数）
+add_executable(${PROJECT_NAME} WIN32 ${SOURCES})
+
+# 添加宏定义
+target_compile_definitions(${PROJECT_NAME} PRIVATE
+    _WIN32
+    UNICODE
+    _UNICODE
+)
+
+# 添加编译选项
+if(CMAKE_C_COMPILER_ID MATCHES "GNU|Clang")
+    target_compile_options(${PROJECT_NAME} PRIVATE
+        -Wall
+        -O2
+        -fexec-charset=UTF-8
+    )
+endif()
+
+# 设置头文件搜索路径
+target_include_directories(${PROJECT_NAME} PRIVATE
+    ${CMAKE_SOURCE_DIR}/include
+    ${CMAKE_SOURCE_DIR}/include/core
+    ${CMAKE_SOURCE_DIR}/include/ui
+    ${CMAKE_SOURCE_DIR}/include/controller
+    ${CMAKE_SOURCE_DIR}/include/utils
+    ${CMAKE_SOURCE_DIR}/libs/IUP/include
+)
+
+# 设置库文件搜索路径
+target_link_directories(${PROJECT_NAME} PRIVATE
+    ${CMAKE_SOURCE_DIR}/libs/IUP
+)
+
+# 链接所需库
+target_link_libraries(${PROJECT_NAME} PRIVATE
+    iup
+    iupcd
+    gdi32
+    comdlg32
+    comctl32
+    uuid
+    ole32
+    advapi32
+)
+
+# 编译完成后，仅将程序实际需要的核心 DLL 文件复制到构建输出目录
+set(IUP_REQUIRED_DLLS "${CMAKE_CURRENT_SOURCE_DIR}/libs/IUP/iup.dll")
+add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
+    COMMAND ${CMAKE_COMMAND} -E copy_if_different
+    ${IUP_REQUIRED_DLLS}
+    "$<TARGET_FILE_DIR:${PROJECT_NAME}>"
+    COMMENT "Copying required DLLs to build directory..."
+)

Makefile

@@ -18,9 +18,9 @@ CFLAGS = -Wall -O2 -I$(INCLUDE_DIR) -I$(LOCAL_INCLUDE_DIR) -D_WIN32 -DUNICODE -D
 LDFLAGS = -L$(LIB_DIR) -liup -liupcd -lgdi32 -lcomdlg32 -lcomctl32 -luuid -lole32 -ladvapi32 -mwindows
 
 # Source
-SRC = src/main.c src/utils.c src/registry.c src/callbacks.c src/ui.c
+SRC = src/main.c src/utils.c src/registry.c src/callbacks.c src/ui.c src/globals.c
 RES = ico/resources.rc
-OBJ = $(OBJ_DIR)/main.o $(OBJ_DIR)/utils.o $(OBJ_DIR)/registry.o $(OBJ_DIR)/callbacks.o $(OBJ_DIR)/ui.o $(OBJ_DIR)/resources.o
+OBJ = $(OBJ_DIR)/main.o $(OBJ_DIR)/utils.o $(OBJ_DIR)/registry.o $(OBJ_DIR)/callbacks.o $(OBJ_DIR)/ui.o $(OBJ_DIR)/globals.o $(OBJ_DIR)/resources.o
 EXE = $(BIN_DIR)/PathEditor.exe
 
 all: $(BIN_DIR) $(OBJ_DIR) $(EXE)
@@ -49,6 +49,9 @@ $(OBJ_DIR)/callbacks.o: src/callbacks.c
 $(OBJ_DIR)/ui.o: src/ui.c
 	$(CC) $(CFLAGS) -c -o $@ $<
 
+$(OBJ_DIR)/globals.o: src/globals.c
+	$(CC) $(CFLAGS) -c -o $@ $<
+
 $(OBJ_DIR)/resources.o: ico/resources.rc
 	$(WINDRES) -i $< -o $@
 

README.md

@@ -33,6 +33,18 @@
 
 * **轻量级**：原生 C 语言编写，无臃肿依赖，运行速度极快。
 
+## 🏗️ 架构与二次开发
+
+本项目注重代码的模块化和可维护性，采用了经典的 **MVC 分层架构**，非常适合作为 C 语言桌面程序开发的参考：
+
+* **分层设计**：
+  * `src/core/` (Model): 核心数据与业务逻辑，完全脱离 UI 框架（无任何 `<iup.h>` 依赖）。
+  * `src/ui/` (View): 负责界面布局与组件的纯视觉展示。
+  * `src/controller/` (Controller): 负责连接用户交互与底层数据。
+  * `src/utils/` (Utils): 纯粹的底层工具类封装（系统级调用、字符串处理）。
+* **统一配置中心**：所有的 UI 尺寸、间距、颜色等常量配置均提取在 `include/config.h` 中，只需修改宏定义即可轻松定制属于你的专属界面风格。
+* **清晰的应用状态**：摒弃了脆弱的全局变量模式，采用 `AppContext` 统一管理应用运行时的上下文状态，通过指针传递，安全可靠。
+
 ## 📦 下载与安装
 
 您可以从 [Releases](https://github.com/LHY0125/PathEditor/releases) 页面下载最新的安装包 (`PathEditorSetup.exe`)。
@@ -47,11 +59,13 @@
 
 * Windows 操作系统
 * GCC 编译器 (推荐 MinGW-w64)
-* Make 工具
+* CMake 工具 (推荐使用 CMake 构建)
 * IUP 库 (已包含在 `libs` 目录下)
 * Inno Setup 6 (仅打包需要)
 
-### 编译步骤
+### 编译步骤 (推荐使用 CMake)
+
+本项目已迁移至 CMake 构建系统，支持生成更标准的构建文件并集成到各大 IDE。
 
 1. 克隆仓库：
 
@@ -60,14 +74,18 @@
    cd PathEditor
    ```
 
-2. 编译项目：
+2. 使用 CMake 配置和编译：
 
    ```bash
-   mingw32-make
+   # 生成构建系统 (以 MinGW 为例)
+   cmake -B build -G "MinGW Makefiles"
+   
+   # 编译项目
+   cmake --build build
    ```
 
 3. 运行：
-   编译成功后，可执行文件位于 `bin/PathEditor.exe`。
+   编译成功后，可执行文件位于 `build/PathEditor.exe`。
 
 ### 打包 (可选)
 

build_installer.bat

@@ -1,7 +1,4 @@
 @echo off
-echo Copying DLLs...
-if not exist bin mkdir bin
-copy /Y "libs\iup-3.31_Win64_dllw6_lib\*.dll" bin\
 
 echo Building Installer...
 "D:\Program Files (x86)\Inno Setup 6\ISCC.exe" "dist\installer.iss"

dist/installer.iss

@@ -37,8 +37,8 @@ Name: "english"; MessagesFile: "compiler:Default.isl"
 Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked
 
 [Files]
-Source: "d:\Code\doing_exercises\programs\PathEditor\bin\{#MyAppExeName}"; DestDir: "{app}"; Flags: ignoreversion
-Source: "d:\Code\doing_exercises\programs\PathEditor\bin\*.dll"; DestDir: "{app}"; Flags: ignoreversion
+Source: "d:\Code\doing_exercises\programs\PathEditor\build\{#MyAppExeName}"; DestDir: "{app}"; Flags: ignoreversion
+Source: "d:\Code\doing_exercises\programs\PathEditor\build\*.dll"; DestDir: "{app}"; Flags: ignoreversion
 ; NOTE: Don't use "Flags: ignoreversion" on any shared system files
 
 [Icons]

include/config.h

@@ -0,0 +1,33 @@
+#ifndef CONFIG_H
+#define CONFIG_H
+
+// ============================================================================
+// UI的配置常量
+// ============================================================================
+
+// 应用程序名称
+#define APP_NAME "PathEditor"    // 编辑环境变量应用程序名称
+#define APP_NAME_READONLY "PathEditor (只读模式)" // 编辑环境变量只读模式标题
+
+// 对话框设置
+#define UI_DLG_SIZE "800x800"    // 对话框默认大小 (像素)
+#define UI_DLG_MINSIZE "800x800" // 对话框最小大小 (像素)
+
+// 列表控件设置
+#define UI_LIST_ITEM_PADDING "5x5"      // 列表项内边距
+#define UI_LIST_BACKCOLOR "255 255 255" // 列表背景颜色
+
+// 按钮设置
+#define UI_BTN_RASTERSIZE "100x32" // 按钮默认大小
+
+// 布局间隙和边距
+#define UI_VBOX_GAP "5"            // 垂直布局项间隙
+#define UI_VBOX_MARGIN "0x0"       // 垂直布局外边距
+#define UI_VBOX_ALL_MARGIN "10x10" // 垂直布局总外边距
+#define UI_VBOX_ALL_GAP "5"        // 垂直布局总间隙
+
+#define UI_HBOX_GAP "10"            // 水平布局项间隙
+#define UI_HBOX_MARGIN "10x10"      // 水平布局外边距
+#define UI_HBOX_ALIGNMENT "ACENTER" // 水平布局对齐方式
+
+#endif // CONFIG_H

include/controller/callbacks.h

@@ -27,4 +27,7 @@ int list_dropfiles_cb(Ihandle *self, const char *filename, int num, int x, int y
 // 键盘按键回调
 int list_k_any_cb(Ihandle *self, int c);
 
+// 载入数据与更新UI
+void load_all_paths(void);
+
 #endif // CALLBACKS_H

include/core/app_context.h

@@ -0,0 +1,22 @@
+#ifndef APP_CONTEXT_H
+#define APP_CONTEXT_H
+
+#include "utils/string_ext.h"
+#include <iup.h>
+
+// 应用上下文结构体,用于存储应用运行时的状态
+typedef struct {
+    StringList sys_paths;
+    StringList user_paths;
+} AppContext;
+
+// 创建应用上下文
+AppContext* create_app_context(void);
+
+// 销毁应用上下文
+void destroy_app_context(AppContext* ctx);
+
+// 获取应用上下文
+AppContext* get_app_context(Ihandle *ih);
+
+#endif // APP_CONTEXT_H

include/core/path_manager.h

@@ -0,0 +1,19 @@
+#ifndef PATH_MANAGER_H
+#define PATH_MANAGER_H
+
+#include "utils/string_ext.h"
+
+// 移除列表中指定索引的项
+void path_manager_remove_at(StringList *list, int index);
+
+// 上移指定索引的项
+void path_manager_move_up(StringList *list, int index);
+
+// 下移指定索引的项
+void path_manager_move_down(StringList *list, int index);
+
+// 清理无效和重复的路径
+// 返回被清理的项数
+int path_manager_clean(StringList *list);
+
+#endif // PATH_MANAGER_H

include/core/registry_service.h

@@ -0,0 +1,14 @@
+#ifndef REGISTRY_SERVICE_H
+#define REGISTRY_SERVICE_H
+
+#include "utils/string_ext.h"
+
+// 加载系统变量和用户变量到字符串列表
+int load_system_paths(StringList *list);
+int load_user_paths(StringList *list);
+
+// 从字符串列表保存系统变量和用户变量
+int save_system_paths(const StringList *list);
+int save_user_paths(const StringList *list);
+
+#endif // REGISTRY_SERVICE_H

include/globals.h

@@ -1,44 +0,0 @@
-#ifndef GLOBALS_H
-#define GLOBALS_H
-
-#include <iup.h>
-
-// 注册表路径常量
-#define REG_PATH_SYS L"SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment"
-#define REG_PATH_USER L"Environment"
-#define REG_VALUE L"Path"
-
-// 全局控件句柄声明
-extern Ihandle *dlg;        // 主对话框句柄
-extern Ihandle *tabs_main;  // 标签页容器
-extern Ihandle *list_sys;   // 系统变量列表
-extern Ihandle *list_user;  // 用户变量列表
-extern Ihandle *lbl_status; // 状态标签句柄
-extern Ihandle *btn_new;    // 新增按钮句柄
-extern Ihandle *btn_edit;   // 编辑按钮句柄
-extern Ihandle *btn_browse; // 浏览按钮句柄
-extern Ihandle *btn_del;    // 删除按钮句柄
-extern Ihandle *btn_up;     // 上移按钮句柄
-extern Ihandle *btn_down;   // 下移按钮句柄
-extern Ihandle *btn_clean;  // 一键清理按钮句柄
-extern Ihandle *btn_ok;     // 确认按钮句柄
-extern Ihandle *btn_cancel; // 取消按钮句柄
-extern Ihandle *btn_help;   // 帮助按钮句柄
-extern Ihandle *txt_search; // 搜索框
-
-// 简单字符串列表结构，用于搜索缓存
-typedef struct {
-    char **items;
-    int count;
-    int capacity;
-} StringList;
-
-extern StringList raw_sys_paths;
-extern StringList raw_user_paths;
-
-// 缓存操作函数声明
-void init_string_list(StringList *list);
-void add_string_list(StringList *list, const char *str);
-void clear_string_list(StringList *list);
-
-#endif // GLOBALS_H

include/registry.h

@@ -1,10 +0,0 @@
-#ifndef REGISTRY_H
-#define REGISTRY_H
-
-// 从注册表加载所有PATH到列表控件
-void load_all_paths();
-
-// 将列表控件中的PATH保存回注册表
-void save_all_paths();
-
-#endif // REGISTRY_H

include/ui.h

@@ -1,15 +0,0 @@
-#ifndef UI_H
-#define UI_H
-
-#include <iup.h>
-
-// 创建列表控件
-Ihandle *create_path_list();
-
-// 创建右侧功能按钮区域
-Ihandle *create_main_buttons();
-
-// 创建底部按钮区域
-Ihandle *create_bottom_buttons();
-
-#endif // UI_H

include/ui/dialogs.h

@@ -0,0 +1,8 @@
+#ifndef DIALOGS_H
+#define DIALOGS_H
+
+// 自定义输入对话框
+// 返回值：0-取消，1-确认
+int custom_input_dialog(const char *title, const char *label_text, char *buffer, int buffer_size);
+
+#endif // DIALOGS_H

include/ui/main_window.h

@@ -0,0 +1,9 @@
+#ifndef MAIN_WINDOW_H
+#define MAIN_WINDOW_H
+
+#include <iup.h>
+
+// 创建主窗口
+Ihandle* create_main_window(void);
+
+#endif // MAIN_WINDOW_H

include/ui/ui_utils.h

@@ -0,0 +1,13 @@
+#ifndef UI_UTILS_H
+#define UI_UTILS_H
+
+#include <iup.h>
+#include "utils/string_ext.h"
+
+// 刷新单个列表框样式
+void refresh_single_list_style(Ihandle *list);
+
+// 同步字符串列表到 UI 列表框
+void sync_string_list_to_ui(Ihandle *list_ui, const StringList *str_list);
+
+#endif // UI_UTILS_H

include/utils.h

@@ -1,30 +0,0 @@
-#ifndef UTILS_H
-#define UTILS_H
-
-#include <windows.h>
-#include <wchar.h>
-#include <iup.h>
-
-// 宽字符转UTF-8
-char* wide_to_utf8(const wchar_t* wstr);
-
-// UTF-8转宽字符
-wchar_t* utf8_to_wide(const char* str);
-
-// 检查管理员权限
-int check_admin();
-
-// 检查路径是否有效（存在且为目录）
-int is_path_valid(const char *path);
-
-// 刷新列表样式（斑马纹）
-void refresh_list_style();
-void refresh_single_list_style(Ihandle *list);
-
-// 备份注册表
-void backup_registry();
-
-// 不区分大小写的字符串查找
-char *stristr(const char *haystack, const char *needle);
-
-#endif // UTILS_H

include/utils/os_env.h

@@ -0,0 +1,13 @@
+#ifndef OS_ENV_H
+#define OS_ENV_H
+
+// 检查是否以管理员权限运行
+int check_admin(void);
+
+// 检查路径是否有效
+int is_path_valid(const char *path);
+
+// 备份注册表
+void backup_registry(void);
+
+#endif // OS_ENV_H

include/utils/string_ext.h

@@ -0,0 +1,24 @@
+#ifndef STRING_EXT_H
+#define STRING_EXT_H
+
+#include <wchar.h>
+
+// 简单字符串列表结构
+typedef struct
+{
+    char **items;
+    int count;
+    int capacity;
+} StringList;
+
+// 字符串列表
+void init_string_list(StringList *list);
+void add_string_list(StringList *list, const char *str);
+void clear_string_list(StringList *list);
+
+// 字符串转换函数
+char *wide_to_utf8(const wchar_t *wstr);
+wchar_t *utf8_to_wide(const char *str);
+char *stristr(const char *haystack, const char *needle);
+
+#endif // STRING_EXT_H