Files
editgpu/README.md
2026-08-26 18:48:17 +08:00

98 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ⚠️ 重要声明 ⚠️
> # 🚨 免责声明
>
> ## 本工具仅供学习交流使用!
>
> ### 请勿用于任何商业用途、违法用途或对他人造成损害的用途!
>
> **使用本工具所造成的一切后果,由使用者自行承担!**
>
> - 修改注册表可能导致系统不稳定、驱动异常、设备无法识别等问题
> - 请在操作前自行备份注册表与重要数据
> - 操作需谨慎,风险自负
---
# 显卡名称修改工具 (GPU Rename)
一个用于修改 Windows 系统显卡显示名称的 Go 命令行小工具。
## ✨ 功能特性
- 自动枚举当前**实际连接**的物理显卡(PCI 总线),过滤掉幽灵设备与虚拟显示适配器
- 显卡数量 > 1 时,列出列表供用户选择
- 支持自定义显卡显示名称
- 修改完成后自动验证结果
- 修改成功后提示重启机器
## 🖥️ 运行环境
- Windows 7 / 8 / 10 / 11
- 需要 **管理员权限** 运行(修改注册表 HKLM 需要)
## 📦 编译
```bash
# 使用 Go 1.21+ 编译
go mod tidy
go build -o editgpu.exe .
```
或直接使用已编译好的 `editgpu.exe`。
## 🚀 使用方法
1. **右键** 以管理员身份运行 `editgpu.exe`
2. 程序自动检测物理显卡:
- 只有 1 块显卡:直接选中
- 多块显卡:输入序号选择要修改的显卡
3. 输入新的显卡名称(直接回车可取消)
4. 程序自动修改注册表并验证
5. 看到「修改成功」提示后,**重启电脑**使修改完全生效
## ⚙️ 工作原理
程序通过 Windows SetupAPI 枚举当前存在的显卡设备:
1. 使用 `DIGCF_PRESENT` 标志只获取当前实际连接的设备,排除历史遗留的幽灵设备
2. 通过 `SPDRP_ENUMERATOR_NAME == "PCI"` 过滤,只保留物理显卡,排除虚拟显示适配器
3. 获取设备实例 ID,映射到注册表路径 `HKLM\SYSTEM\CurrentControlSet\Enum\...`
4. 修改该路径下的 `DeviceDesc` 注册表值
## 📁 文件结构
```
editgpu/
├── main.go # 主程序源码
├── go.mod # Go 模块配置
├── go.sum # 依赖校验文件
└── README.md # 本说明文档
```
## ❓ 常见问题
**Q:提示「请以管理员身份运行」?**
A:修改注册表需要管理员权限,请右键选择「以管理员身份运行」。
**Q:修改后设备管理器不显示新名称?**
A:请重启电脑,重启后设备管理器会刷新显示新名称。
**Q:修改名称会影响显卡性能吗?**
A:不会,仅修改显示名称,不影响硬件本身与驱动功能。
**Q:如何恢复原始名称?**
A:重新运行本工具,输入原始显卡名称再次修改即可;或到设备管理器卸载设备后重新扫描硬件。
---
# ⚠️ 再次提醒 ⚠️
> ## 本工具仅供学习交流使用
>
> ### 因使用本工具产生的一切后果,由使用者自行承担!
>
> #### 请勿将本工具用于非法用途、商业用途或损害他人利益!