Windows右键菜单添加Cursor编辑器：注册表原理与一键部署指南

1. 项目概述：为Windows右键菜单注入“Cursor”灵魂

如果你和我一样，日常开发的主力编辑器已经从经典的VS Code切换到了Cursor，那你一定也经历过这个小小的烦恼：想快速用Cursor打开一个文件夹或文件，却总是要先打开Cursor，再从“文件”菜单里一层层点进去，或者更麻烦地，把文件拖拽到Cursor的图标上。这个操作流程在效率至上的开发工作流里，显得格外刺眼。我们早已习惯了在文件资源管理器里，对着任何文件或文件夹右键，就能看到“用VS Code打开”的选项，那种丝滑感，正是Cursor目前所缺失的。

今天要聊的这个开源项目，就是为了解决这个痛点而生的。它叫open-with-cursor-context-menu，来自开发者Puliczek。本质上，它是一组PowerShell脚本，通过修改Windows注册表，将“Open with Cursor”这个选项，像植入基因一样，添加到你的右键上下文菜单中。无论是单个文件、整个文件夹，还是在文件夹空白处点击，你都能看到这个熟悉的选项，一键直达，彻底告别繁琐的中间步骤。

这不仅仅是一个“方便”的小工具，它代表了一种工作流思维：让工具无缝融入操作系统，减少认知和操作负担。对于深度依赖Cursor进行AI辅助编程、代码阅读和项目管理的开发者来说，这个改动带来的效率提升是实打实的。接下来，我会带你从原理到实操，完整地走一遍这个项目的部署、使用和深度定制过程，并分享一些我踩过坑之后总结出来的经验。

2. 核心原理深度解析：Windows右键菜单的注册表魔法

在动手之前，我们有必要搞清楚这个脚本到底做了什么。知其然，更要知其所以然，这样即使未来遇到问题，你也能自己排查，甚至进行定制。

2.1 Windows右键菜单的运作机制

Windows的右键菜单，专业名称叫“Shell Context Menu”，它的配置信息几乎全部存储在Windows注册表中。你可以把注册表想象成一个庞大的、层级分明的配置数据库。右键菜单的每一项，都对应着这个数据库里的一个或多个键值。

具体到“用某个程序打开”这类菜单项，其信息主要存放在以下几个注册表路径下：

1. 针对所有文件类型：HKEY_CLASSES_ROOT\*\shell\
2. 针对特定文件扩展名（如.txt）：HKEY_CLASSES_ROOT\.txt\OpenWithList\
3. 针对目录（文件夹）：HKEY_CLASSES_ROOT\Directory\shell\
4. 针对目录背景（文件夹空白处）：HKEY_CLASSES_ROOT\Directory\Background\shell\
5. 针对“此电脑”/桌面背景等：HKEY_CLASSES_ROOT\Drive\shell\或HKEY_CLASSES_ROOT\DesktopBackground\shell\

这个项目主要操作的就是第1、3、4类。当你在资源管理器里右键时，系统会检查当前选中对象的类型（是文件、文件夹还是空白区域），然后去对应的注册表路径下读取所有配置，并动态生成菜单。

2.2 脚本如何“注入”菜单项

项目提供的install-open-with-cursor.ps1脚本，核心工作就是向上述注册表路径写入特定的键和值。我们拆解一下它写入的内容（以文件夹为例）：

1. 创建主键：在HKEY_CLASSES_ROOT\Directory\shell\下创建一个名为OpenWithCursor的新键。这个名字可以自定义，但要有辨识度。
2. 设置显示名称：在刚创建的OpenWithCursor键下，创建一个字符串值（REG_SZ），名称为MUIVerb，数据为Open with Cursor。MUIVerb就是最终显示在右键菜单上的文字。
3. 设置图标：在OpenWithCursor键下，创建一个字符串值Icon，其数据设置为Cursor可执行文件（cursor.exe）的完整路径。这样菜单项前面就会显示Cursor的图标，视觉上更统一。
4. 创建命令子键：在OpenWithCursor键下，再创建一个名为command的子键。
5. 定义执行命令：在command键下，设置默认值（也是一个REG_SZ），其数据就是最终要执行的命令。对于打开文件夹，命令通常是："C:\Users\YourName\AppData\Local\Programs\cursor\cursor.exe" "%V"。
   • "..."：包裹的是Cursor程序的绝对路径，确保系统能找到它。
   • "%V"：这是一个重要的Shell变量，代表被右键点击的对象路径。对于文件夹，它就是文件夹路径；对于文件，就是文件路径。这确保了无论你点哪里，Cursor都能正确打开目标。

注意：修改HKEY_CLASSES_ROOT下的内容通常需要管理员权限，这就是为什么运行脚本时会弹出UAC（用户账户控制）提示要求提权。这是正常且必要的安全机制。

2.3 卸载脚本的逆向操作

理解了安装，卸载就很简单了。uninstall-open-with-cursor.ps1脚本的工作就是找到安装时创建的那些注册表键（OpenWithCursor和其下的command），并将它们整个删除。删除后，系统在生成右键菜单时就读不到这些配置了，菜单项自然消失。

这种“增删改查”注册表的方式，是Windows平台下定制化Shell体验的经典方法，很多右键菜单管理工具（如Context Menu Manager）底层也是基于此原理。

3. 完整部署与安装实操指南

理论清楚了，我们开始动手。我将过程细化为几个步骤，并补充官方文档里可能没提到的细节。

3.1 前置检查与准备

在运行任何脚本之前，做好准备工作能避免很多问题。

1. 确认Cursor已安装且路径正常：打开“开始”菜单，搜索“Cursor”，右键选择“打开文件位置”。这通常会跳转到Cursor的快捷方式，你可以再次右键快捷方式选择“属性”，在“目标”栏里看到类似C:\Users\[你的用户名]\AppData\Local\Programs\cursor\cursor.exe的路径。记下这个路径，或者确认它是否存在。默认安装的话，脚本能自动找到，但如果你安装在了D盘或其他自定义位置，后续可能需要手动调整脚本。
2. 选择合适的脚本获取方式：你有两种主流方式下载脚本。
   • 方式一（推荐，便于更新）：直接访问项目的GitHub仓库页面（https://github.com/Puliczek/open-with-cursor-context-menu）。点击绿色的“Code”按钮，选择“Download ZIP”，下载整个项目压缩包。解压后，你可以在里面找到.ps1和.bat文件。这种方式你能看到所有相关文件。
   • 方式二（快速）：按照项目说明，分别单独下载install-open-with-cursor.ps1和uninstall-open-with-cursor.ps1两个脚本文件。右键链接，选择“链接另存为...”。

3.2 执行安装脚本的详细过程

下载好install-open-with-cursor.ps1文件后，不要直接双击。

1. 以管理员身份运行PowerShell脚本：

   • 在文件资源管理器中，找到下载的.ps1文件。
   • 右键点击该文件，在弹出的菜单中，找到并选择“使用PowerShell运行”。如果右键菜单里没有，可以按住Shift键再右键，就会出现“在此处打开PowerShell窗口”或“使用PowerShell运行”的选项。
   • 最关键的一步：系统一定会弹出用户账户控制（UAC）窗口，询问“是否允许此应用对你的设备进行更改？”，你必须点击“是”。因为修改注册表需要管理员权限。如果点了“否”，脚本会运行但什么也不会发生。

2. 理解脚本的执行流程：点击“是”后，一个蓝底或黑底的PowerShell窗口会快速闪过并可能自动关闭。脚本在背后做了这几件事：

   • 自我提权：脚本开头会检查当前是否以管理员身份运行。如果不是，它会用管理员权限重新启动自己，这就是你看到UAC弹窗的原因。
   • 查找Cursor：脚本会尝试在几个默认路径（主要是$env:LOCALAPPDATA\Programs\cursor\）寻找cursor.exe。
   • 写入注册表：找到exe后，脚本会按照我们前面讲的原理，向三个位置（*\shell\,Directory\shell\,Directory\Background\shell\）写入注册表项。
   • 输出结果：如果一切顺利，窗口关闭前你可能看到“Successfully added...”之类的成功信息。

3.3 安装后的验证与菜单刷新

脚本运行完成后，右键菜单可能不会立即更新。这是因为资源管理器（explorer.exe）缓存了菜单信息。

1. 立即刷新资源管理器：最有效的方法是重启资源管理器进程。你可以按照项目文档的方法，用管理员终端执行Stop-Process -Name explorer -Force; Start-Process explorer。但我更推荐一个更简单直观的方法：

   • 按下Ctrl + Shift + Esc打开任务管理器。
   • 在“进程”选项卡中找到“Windows 资源管理器”。
   • 右键点击它，选择“重新启动”。
   • 任务栏和桌面会短暂消失并重新加载，这个过程大约2-3秒。完成后，右键菜单的缓存就被清除了。

2. 验证菜单项：

   • 找一个文件夹，在空白处右键，你应该能看到“Open with Cursor”选项。
   • 右键点击一个文件夹图标本身，也应该能看到该选项。
   • 右键点击一个文件（比如.js,.py,.txt文件），同样应该能看到。
   • 点击一下，看看是否能正常用Cursor打开目标。

实操心得：有时候即使重启了资源管理器，菜单项也可能延迟出现。如果没看到，可以尝试直接注销当前Windows用户再登录，或者重启电脑，这能确保万无一失。另外，某些第三方系统优化软件或右键菜单管理工具可能会冲突，如果始终不出现，可以暂时退出这些软件再试。

4. 故障排查与常见问题解决实录

即使步骤正确，你也可能会遇到一些问题。下面是我在多次安装和帮别人部署时遇到的典型情况及其解决方案。

4.1 脚本无法运行：执行策略限制

这是最常见的问题。当你尝试运行.ps1脚本时，PowerShell窗口一闪而过，或者显示红色错误信息，提示“无法加载文件...，因为在此系统上禁止运行脚本”。

问题根源：Windows PowerShell默认有一个严格的执行策略（Execution Policy），目的是防止运行恶意脚本。从互联网下载的脚本（如GitHub）默认被标记为“远程”脚本，因此被阻止。

解决方案：你需要临时放宽当前用户的执行策略。注意，以下操作只需在安装或卸载时做一次，完成后强烈建议改回安全设置。

1. 以管理员身份打开Windows PowerShell（在开始菜单搜索PowerShell，右键选择“以管理员身份运行”）。
2. 输入以下命令并回车，这将允许当前用户运行任何脚本：

   Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser

3. 系统会提示你是否确认更改，输入Y并回车。
4. 此时再去右键“使用PowerShell运行”你的安装脚本，应该就能正常执行了。
5. 重要：脚本成功运行后，请务必恢复安全策略。回到管理员PowerShell窗口，运行：

   Set-ExecutionPolicy -ExecutionPolicy Default -Scope CurrentUser

   Default策略通常等同于Restricted（受限），这是最安全的状态。

注意事项：永远不要将执行策略设置为Unrestricted并应用于LocalMachine（所有用户），这会带来安全风险。始终使用-Scope CurrentUser仅为当前用户临时放宽。

4.2 菜单项不出现或点击无反应

如果菜单项没出现，或者点击后没任何反应（Cursor没启动），可以按以下顺序排查：

1. 检查Cursor路径：这是最可能的原因。脚本可能没找到你的Cursor.exe。打开安装脚本（用记事本即可），找到类似$cursorPath = "$env:LOCALAPPDATA\Programs\cursor\cursor.exe"的行。检查这个路径在你的电脑上是否存在。如果Cursor安装在其他地方（比如D:\Tools\Cursor\），你需要手动修改这个变量，将其指向正确的完整路径，然后保存脚本再运行。
2. 手动刷新注册表与资源管理器：确保你已经按照“3.3”节的方法重启了资源管理器。也可以尝试在任务管理器中多重启几次。
3. 检查注册表是否写入成功：按下Win + R，输入regedit打开注册表编辑器（操作前建议备份注册表）。导航到计算机\HKEY_CLASSES_ROOT\Directory\shell\，看下面是否存在OpenWithCursor键。如果存在，点击它，查看右侧Icon和command子键下的默认值是否正确指向了你的Cursor路径。如果路径错误，可以在这里直接双击修改。
4. 冲突的Shell扩展：如果你安装了诸如“Git for Windows”并在右键菜单中添加了Git Bash、Git GUI等，或者有其他的文件管理器增强软件，极少数情况下可能会造成菜单加载冲突。可以尝试暂时禁用其他第三方Shell扩展进行测试。

4.3 使用批处理文件(.bat)的替代方案

在项目的GitHub仓库里，你可能会发现一个叫cursorOpenFolder.bat的文件（由贡献者@eatcosmos提供）。这是一种更“古典”但有时更稳定的方法。

原理：这个.bat批处理文件内部使用的是.reg文件（注册表脚本）。它直接将写好的注册表项内容导出为一个.reg文件，然后通过regedit /s命令静默导入注册表。

操作方法：

1. 下载cursorOpenFolder.bat。
2. 同样需要右键，选择“以管理员身份运行”。
3. 它会自动生成并导入注册表文件，效果和PowerShell脚本一样。

优缺点对比：

• 优点：对PowerShell执行策略不敏感，在某些严格限制PS的电脑上可能更容易成功。过程更透明，你可以用记事本打开.bat文件查看它具体要写入什么。
• 缺点：.bat文件通常只处理了“打开文件夹”这一种场景（具体看文件内容），而PS脚本通常更全面（文件、文件夹、背景）。且.bat文件的路径通常是硬编码的，如果Cursor安装路径不同，你需要手动编辑.bat文件来修改路径，比修改PS变量稍麻烦一点。

5. 高级定制与个性化配置

如果你不满足于基础功能，想对这个右键菜单项进行一些个性化调整，完全可以手动编辑注册表或修改脚本。

5.1 修改菜单项显示名称和图标

你觉得“Open with Cursor”这个名字太长，想改成“用Cursor打开”或者简单的“Cursor”？

1. 打开注册表编辑器 (regedit)，导航到对应的键，例如HKEY_CLASSES_ROOT\Directory\shell\OpenWithCursor。
2. 在右侧找到MUIVerb，双击它，将数值数据修改为你想要的名称，比如Cursor。
3. 修改后，同样需要重启资源管理器才能生效。

图标同理，你可以修改Icon的值，指向任何一个.ico图标文件或者.exe文件（.exe文件会使用其内嵌的第一个图标）。例如，你可以指向一个自定义的图标文件：C:\Icons\my-cursor.ico。

5.2 为特定文件类型添加菜单

默认脚本为“所有文件(*)”添加了菜单。但有时你可能只想对代码文件（如.js,.py,.cpp）显示这个选项，而对图片、视频文件不显示，以免右键菜单太乱。

这需要为特定扩展名单独添加注册表项。例如，只为.py文件添加：

1. 在注册表中创建路径HKEY_CLASSES_ROOT\.py\shell\OpenWithCursor\command。
2. 在command键的默认值里，填入"你的Cursor路径" "%1"。注意，这里用的是%1而不是%V，它代表第一个选中的文件。

你可以手动操作，但更高效的方法是修改安装脚本，让它循环遍历一个你定义的文件扩展名数组，为每个扩展名创建相应的注册表项。这需要一定的PowerShell或编程知识。

5.3 创建带参数的快捷方式（进阶）

有时，我们可能希望右键菜单能以特定模式打开Cursor。例如，总是以“新建窗口”模式打开，或者禁用某些插件。

Cursor的命令行参数可能不像VS Code那样有完善的官方文档，但通常可以通过cursor.exe --help在终端查看。假设你发现--disable-extensions参数可以禁用所有扩展（用于排查问题），那么你可以这样修改命令： 将注册表command键的默认值改为："C:\...\cursor.exe" --disable-extensions "%V"

这样，通过右键菜单打开的Cursor实例就会处于无扩展状态。你可以探索其他有用的参数来定制你的启动行为。

6. 安全卸载与系统清理

当你不再需要这个功能，或者想重装时，干净地移除它很重要。

1. 使用官方卸载脚本：运行uninstall-open-with-cursor.ps1（同样需要管理员权限）。这是最推荐、最安全的方式，它能精确删除当初安装时创建的所有条目。
2. 手动清理注册表（备用）：如果卸载脚本丢失或失效，可以手动删除。
   • 打开regedit。
   • 删除以下三个键（如果存在）：
     • HKEY_CLASSES_ROOT\*\shell\OpenWithCursor
     • HKEY_CLASSES_ROOT\Directory\shell\OpenWithCursor
     • HKEY_CLASSES_ROOT\Directory\Background\shell\OpenWithCursor
   • 警告：操作注册表前请务必谨慎，误删其他键可能导致系统或软件异常。建议先导出要删除的键作为备份。
3. 卸载后的菜单残留：有时即使删除了注册表项，由于系统图标缓存等原因，旧的菜单项文字可能还会短暂出现，但点击无效。此时可以尝试重启电脑，或者使用一些专业的系统清理工具（如CCleaner）清理Shell图标和菜单缓存。

我个人在实际使用中，这个项目提供的脚本非常稳定，安装卸载多次都未留下任何残留。它通过精准地定位自己创建的注册表键来删除，不会影响到系统其他部分，这种“自包含”的设计值得称赞。整个体验下来，最大的感触就是：一个看似微小的工具，当它精准地解决了一个高频痛点时，带来的幸福感是巨大的。现在，无论是在项目文件夹里右键打开整个工作区，还是快速用Cursor查看一个单独的配置文件，都变得无比自然流畅，这大概就是“工匠精神”在效率工具上的体现吧。如果你也厌倦了低效的打开方式，不妨花五分钟试试这个方案，它很可能成为你日后离不开的一个小细节。