本脚本是一款适配 Windows 默认 PowerShell 5.1 的交互式 PATH 环境变量管理器，旨在解决日常 PATH 维护中的痛点（如路径臃肿、无效路径堆积、批量操作繁琐等）。脚本无需管理员权限，操作友好，支持核心的 PATH 增删改查、无效路径清理、操作历史追溯等功能，兼顾普通用户手动操作和基础脚本集成需求。
-
查看PATH列表：自动去重、按字母排序，以序号形式展示，提升可读性；
-
添加路径：支持单个路径添加（自动去重、存在性校验）和批量路径添加（多行输入，空行结束）；
-
删除路径：支持通过序号或完整路径删除，输入容错处理，避免误操作；
-
清理无效路径：自动检测“不存在”或“非文件夹”的无效路径，支持一键清理；
-
操作历史记录：记录最近20条操作（时间、操作类型、路径数变化），方便追溯；
-
重置PATH：支持清空当前用户PATH（二次确认，降低误操作风险）。
-
系统：Windows 10 / Windows 11（默认搭载 PowerShell 5.1）；
-
运行环境：PowerShell 5.1+（兼容更高版本，如 PowerShell 7+）；
-
权限：无需管理员权限（仅修改当前用户的 PATH，不影响系统级 PATH）；
-
编码要求：脚本文件需保存为 UTF-8 with BOM 编码（避免中文乱码）。
-
下载脚本文件：将最终兼容版脚本保存为
Manage-UserPath-BasicOpt.ps1； -
选择保存路径：建议保存到固定目录（如
D:\new_learn\Manage-UserPath-BasicOpt\），方便后续调用； -
确认编码：用记事本/VS Code 打开脚本，检查并设置编码为 UTF-8 with BOM（记事本：另存为 → 编码选择“UTF-8”；VS Code：右下角编码 → 保存时使用编码 → 选择“UTF-8 with BOM”）。
-
打开 PowerShell 5.1（按下
Win + R，输入powershell，回车）； -
切换到脚本所在目录（示例命令，需根据实际保存路径修改）：
cd D:\new_learn\Manage-UserPath-BasicOpt -
执行脚本：
.\Manage-UserPath-BasicOpt.ps1 -
脚本启动后，将显示彩色主菜单，按提示输入数字选择操作。
| 操作序号 | 操作名称 | 操作步骤 |
|---|---|---|
| 1 | 查看PATH列表 | 输入 1 回车，将以序号+排序形式展示当前用户的所有有效PATH路径。 |
| 2 | 添加单个路径 | 输入 2 回车 → 输入要添加的完整路径（按Tab可自动补全）→ 回车确认；脚本会自动校验路径是否存在、是否重复，无需手动处理。 |
| 3 | 批量添加路径 | 输入 3 回车 → 每行输入1个路径（按Tab补全）→ 输入空行结束批量输入；脚本自动去重并合并到现有PATH。 |
| 4 | 删除路径 | 输入 4 回车 → 可输入路径序号（参考列表）或完整路径 → 回车后确认删除（输入Y确认，N取消）。 |
| 5 | 清理无效路径 | 输入 5 回车 → 脚本自动检测无效路径（不存在/非文件夹）→ 显示检测结果后，输入Y确认清理，N取消。 |
| 6 | 查看操作历史 | 输入 6 回车，展示最近20条操作记录（含时间、操作类型、路径数变化）。 |
| 7 | 重置PATH | 输入 7 回车 → 需输入“确认重置”四字验证 → 再次输入Y确认清空，N取消（谨慎使用！）。 |
| 8 | 退出程序 | 输入 8 回车，关闭脚本。 |
现象：脚本提示文案显示为乱码（如 鏈€鍚庣‘璁わ細鏄惁娓呯┖）；
原因：脚本编码不是 UTF-8 with BOM；
解决：重新保存脚本，选择编码为“UTF-8 with BOM”（参考安装步骤3）。
现象：执行保存操作时提示“找不到与参数名称‘Indent’匹配的参数”；
原因：PowerShell 5.1 不支持 ConvertTo-Json -Indent 参数；
解决：使用最终兼容版脚本（已移除 -Indent 参数，不影响功能）。
现象：保存PATH时提示“[System.Management.Automation.PSObject] 不包含名为‘op_Addition’的方法”； 原因：PowerShell 5.1 中数组与 PSObject 拼接冲突； 解决：使用最终兼容版脚本（改用 ArrayList 处理历史记录，彻底规避该问题）。
现象：执行脚本时提示“无法加载文件...因为在此系统上禁止运行脚本”；
原因：PowerShell 执行策略限制；
解决：在 PowerShell 中执行以下命令（仅允许当前用户运行签名脚本）：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
输入Y确认，之后重新执行脚本。
-
脚本仅修改 当前用户 的 PATH 环境变量，不会影响系统级 PATH（安全无风险）；
-
历史记录文件默认保存到
%APPDATA%\PathHistory.json（用户目录，无权限问题），最大保留20条记录； -
若需集成到其他脚本，可基于现有函数扩展（如新增静默模式参数）。
MIT许可