Windows 11 下 VSCode 右键菜单“通过 Code 打开”中文乱码：原因与修复

1
<#
2
.SYNOPSIS
3
    为 HKLM 下的 VSCodeContextMenu 添加 Title 值，解决右键菜单乱码问题。
4
.DESCRIPTION
5
    此脚本仅在 HKLM\SOFTWARE\Classes\VSCodeContextMenu 下操作：
6
    - 如果项不存在，则创建；
7
    - 然后添加（或修改）名为 Title 的可扩充字符串值，数据为“通过 Code 打开”。
8
    操作前自动提权，不备份注册表，但生成详细日志到桌面，便于排查问题。
9
.PRINCIPLE
10
    问题根源：HiBit Uninstaller 在 HKLM 下创建了空的 VSCodeContextMenu 项，
11
    而 Windows 11 优先读取 HKLM 下的配置，导致菜单显示乱码。
12
    添加 Title 值后，HKLM 下的项有了有效数据，系统就能正常显示。
13
.NOTES
14
    需要管理员权限。脚本会自动提权。
15
    只操作指定项，不影响其他注册表位置。
16
#>
17

18
# ========== 自动提权 ==========
19
$isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")
20
if (-not $isAdmin) {
21
    $scriptPath = $MyInvocation.MyCommand.Path
22
    if ($scriptPath) {
23
        Write-Host "当前不是管理员权限，正在尝试以管理员身份重新启动..." -ForegroundColor Yellow
24
        Start-Process PowerShell -Verb RunAs -ArgumentList "-NoProfile -ExecutionPolicy Bypass -File `"$scriptPath`""
25
        exit
26
    } else {
27
        Write-Host "错误：需要管理员权限才能运行此脚本。" -ForegroundColor Red
28
        Write-Host "请关闭此窗口，然后右键点击 PowerShell 选择“以管理员身份运行”，再重新粘贴脚本。" -ForegroundColor Yellow
29
        Read-Host "按回车键退出"
30
        exit
31
    }
32
}
33

34
# ========== 设置日志路径 ==========
35
$logDir = "$env:USERPROFILE\Desktop"
36
$logName = "AddVSCodeTitle_$(Get-Date -Format 'yyyyMMdd_HHmmss').log"
37
$logFile = Join-Path $logDir $logName
38

39
# 日志写入函数
40
function Write-Log {
41
    param([string]$Message)
42
    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss.fff"
43
    $logLine = "$timestamp - $Message"
44
    Add-Content -Path $logFile -Value $logLine -Encoding UTF8
45
    Write-Host $Message
46
}
47

48
# 初始化日志
49
Write-Log "========================================"
50
Write-Log "VSCode 右键菜单修复工具 (添加Title值) - 操作日志"
51
Write-Log "开始时间: $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
52
Write-Log "========================================"
53
Write-Log "操作目标: HKLM\SOFTWARE\Classes\VSCodeContextMenu"
54
Write-Log "操作内容: 设置 Title = '通过 Code 打开' (类型: 可扩充字符串值)"
55
Write-Log ""
56

57
# ========== 定义路径 ==========
58
$regPath = "HKLM:\SOFTWARE\Classes\VSCodeContextMenu"
59
$valueName = "Title"
60
$valueData = "通过 Code 打开"
61
$valueType = "ExpandString"
62

63
# ========== 检查并创建项 ==========
64
Write-Log "[1] 检查目标项是否存在..."
65
if (-not (Test-Path $regPath)) {
66
    Write-Log "    目标项不存在，正在创建..."
67
    try {
68
        New-Item -Path $regPath -Force -ErrorAction Stop | Out-Null
69
        Write-Log "    创建成功。"
70
    } catch {
71
        Write-Log "    创建失败！错误信息: $_"
72
        Write-Log "    请检查权限或路径是否正确。"
73
        Write-Log "操作中止。"
74
        Read-Host "按回车键退出"
75
        exit 1
76
    }
77
} else {
78
    Write-Log "    目标项已存在。"
79
}
80

81
# ========== 记录当前状态（如果有Title值） ==========
82
try {
83
    $currentValue = Get-ItemProperty -Path $regPath -Name $valueName -ErrorAction SilentlyContinue
84
    if ($currentValue -and $currentValue.Title) {
85
        Write-Log "[2] 当前 Title 值已存在，内容为: '$($currentValue.Title)'"
86
        Write-Log "    将覆盖为新值。"
87
    } else {
88
        Write-Log "[2] 当前 Title 值不存在，将新建。"
89
    }
90
} catch {
91
    Write-Log "[2] 读取当前值失败（不影响后续操作）: $_"
92
}
93

94
# ========== 设置 Title 值 ==========
95
Write-Log "[3] 正在设置 Title 值..."
96
try {
97
    Set-ItemProperty -Path $regPath -Name $valueName -Value $valueData -Type $valueType -Force -ErrorAction Stop
98
    Write-Log "    设置成功。"
99
} catch {
100
    Write-Log "    设置失败！错误信息: $_"
101
    Write-Log "操作中止。"
102
    Read-Host "按回车键退出"
103
    exit 1
104
}
105

106
# ========== 验证设置结果 ==========
107
Write-Log "[4] 验证设置结果..."
108
try {
109
    $newValue = Get-ItemProperty -Path $regPath -Name $valueName -ErrorAction SilentlyContinue
110
    if ($newValue -and $newValue.Title -eq $valueData) {
111
        Write-Log "    验证通过，Title 值为: '$($newValue.Title)'"
112
    } else {
113
        Write-Log "    验证失败！当前值为: $($newValue.Title)，期望为: '$valueData'"
114
        Write-Log "    请手动检查注册表。"
115
    }
116
} catch {
117
    Write-Log "    验证时出错: $_"
118
}
119

120
# ========== 完成 ==========
121
Write-Log "========================================"
122
Write-Log "操作完成时间: $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
123
Write-Log "日志文件保存至: $logFile"
124
Write-Log "========================================"
125
Write-Log ""
126
Write-Log "请重启文件资源管理器或注销重新登录以使更改生效。"
127

128
Read-Host "按回车键退出"

1
<#
2
.SYNOPSIS
3
    自动删除由 HiBit Uninstaller 在 HKLM 下创建的、与 VSCode 相关的空注册表项。
4
.DESCRIPTION
5
    此脚本扫描 HKLM\SOFTWARE\Classes 下与 HKCU\Software\Classes 同名且为空的项，
6
    仅处理项名称中包含 "VSCode"（不区分大小写）的项，直接删除，无需用户确认。
7
    操作前会自动提升管理员权限，并在用户下载目录下生成详细日志。
8
.PRINCIPLE
9
    问题根源：HiBit Uninstaller 扫描时，会在 HKLM\SOFTWARE\Classes 下创建与 HKCU 中同名
10
    的空项。系统读取右键菜单时，优先使用 HKLM 下的空项，导致显示异常。
11
    删除这些空项后，系统回落到 HKCU 中的正确配置，右键菜单恢复正常。
12
    此脚本只删除 VSCode 相关的空项，不影响其他软件。
13
.NOTES
14
    需要管理员权限。脚本会自动提权。
15
#>
16

17
# ========== 自动提权 ==========
18
$isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")
19
if (-not $isAdmin) {
20
    $scriptPath = $MyInvocation.MyCommand.Path
21
    if ($scriptPath) {
22
        Write-Host "当前不是管理员权限，正在尝试以管理员身份重新启动..." -ForegroundColor Yellow
23
        Start-Process PowerShell -Verb RunAs -ArgumentList "-NoProfile -ExecutionPolicy Bypass -File `"$scriptPath`""
24
        exit
25
    } else {
26
        Write-Host "错误：需要管理员权限才能运行此脚本。" -ForegroundColor Red
27
        Write-Host "请关闭此窗口，然后右键点击 PowerShell 选择“以管理员身份运行”，再重新粘贴脚本。" -ForegroundColor Yellow
28
        Read-Host "按回车键退出"
29
        exit
30
    }
31
}
32

33
# ========== 设置日志路径 ==========
34
$logDir = "$env:USERPROFILE\Downloads"
35
$logName = "FixVSCodeMenu_$(Get-Date -Format 'yyyyMMdd_HHmmss').log"
36
$logFile = Join-Path $logDir $logName
37

38
# 写入日志头部
39
$logContent = @"
40
========================================
41
VSCode 右键菜单修复工具 - 操作日志
42
时间: $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')
43
脚本版本: 1.0
44
========================================
45

46
[原理]
47
HiBit Uninstaller 扫描注册表时，会在 HKLM\SOFTWARE\Classes 下创建与 HKCU\Software\Classes
48
中同名且为空的项。系统读取右键菜单时优先使用 HKLM 下的空项，导致显示异常。
49
本脚本删除这些与 VSCode 相关的空项，恢复正确的菜单显示。
50

51
[操作]
52
扫描并删除 HKLM\SOFTWARE\Classes 下与 HKCU\Software\Classes 同名且为空的项，
53
且项名称包含 "VSCode"（不区分大小写）。
54
无需用户确认，自动执行。
55

56
[执行结果]
57
"@
58

59
# 写入初始日志
60
$logContent | Out-File -FilePath $logFile -Encoding UTF8
61

62
# ========== 定义路径和关键词 ==========
63
$hkcuPath = "HKCU:\Software\Classes"
64
$hklmPath = "HKLM:\SOFTWARE\Classes"
65
$keyword = "VSCode"
66

67
# 扫描并删除
68
Write-Host "正在扫描注册表，请稍候..." -ForegroundColor Yellow
69

70
# 预加载 HKLM 所有子项名到哈希表（加速）
71
$hklmExistItems = @{}
72
if (Test-Path $hklmPath) {
73
    Get-ChildItem $hklmPath -ErrorAction SilentlyContinue | ForEach-Object {
74
        $hklmExistItems[$_.PSChildName] = $true
75
    }
76
}
77

78
$deletedItems = @()
79
$failedItems = @()
80

81
if (Test-Path $hkcuPath) {
82
    $hkcuNames = Get-ChildItem $hkcuPath | Select-Object -ExpandProperty PSChildName
83
    foreach ($name in $hkcuNames) {
84
        # 关键词过滤
85
        if ($name -like "*$keyword*") {
86
            if ($hklmExistItems.ContainsKey($name)) {
87
                $hklmItem = Join-Path $hklmPath $name
88
                $key = Get-Item $hklmItem -ErrorAction SilentlyContinue
89
                if ($null -ne $key) {
90
                    $hasSubkeys = $key.GetSubKeyNames().Count -gt 0
91
                    $hasValues  = $key.GetValueNames().Count -gt 0
92
                    if (-not $hasSubkeys -and -not $hasValues) {
93
                        try {
94
                            Remove-Item $hklmItem -Force -ErrorAction Stop
95
                            $deletedItems += $hklmItem
96
                            Write-Host "已删除: $hklmItem" -ForegroundColor Green
97
                        } catch {
98
                            $failedItems += "$hklmItem (错误: $($_.Exception.Message))"
99
                            Write-Host "删除失败: $hklmItem" -ForegroundColor Red
100
                        }
101
                    }
102
                }
103
            }
104
        }
105
    }
106
}
107

108
# 写入删除记录
109
$logContent = @"
110
`n[删除的项] (共 $($deletedItems.Count) 项)
111
"@
112
if ($deletedItems.Count -gt 0) {
113
    $logContent += ($deletedItems | ForEach-Object { "  $_" }) -join "`n"
114
} else {
115
    $logContent += "  无"
116
}
117

118
$logContent += @"
119

120
`n[失败的项] (共 $($failedItems.Count) 项)
121
"@
122
if ($failedItems.Count -gt 0) {
123
    $logContent += ($failedItems | ForEach-Object { "  $_" }) -join "`n"
124
} else {
125
    $logContent += "  无"
126
}
127

128
$logContent += @"
129

130
`n[完成时间] $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')
131
========================================
132
"@
133

134
# 追加到日志文件
135
$logContent | Out-File -FilePath $logFile -Encoding UTF8 -Append
136

137
# 控制台输出
138
Write-Host "`n操作完成！" -ForegroundColor Green
139
Write-Host "成功删除 $($deletedItems.Count) 项，失败 $($failedItems.Count) 项。" -ForegroundColor Cyan
140
Write-Host "详细日志已保存至: $logFile" -ForegroundColor Yellow
141
Write-Host "请重启文件资源管理器或注销重新登录以使更改生效。" -ForegroundColor Cyan
142

143
Read-Host "按回车键退出"