开发过程优化·自定义鼠标右键菜单

news2025/1/4 5:49:05

为了改善日常工作中的开发体验，我希望在某个项目目录下点击鼠标右键的快捷菜单，让程序自动为该项目引入一个内部的工具库文件并挂载到项目中。

实现该功能需要组装一些零碎的电脑应用知识，下面徐徐渐进依次说明：

1、在右键菜单中添加一级菜单

1）运行“regedit”打开注册表编辑器；

2）找到“HKEY_CLASSES_ROOT\Directory\Background\shell（针对文件夹空白处右键菜单）”，在左侧树shell下新建一个子项（例如：front_tools），并设置该子项右侧的默认值（该值是右键菜单中显示的文案，缺省则会使用子项的左侧树名称）；

3）在上述子项（front_tools）下新建一个子项“command”，在其右侧的默认值中设置想要调用的程序（例如：此处设置nodejs程序，若要执行JS脚本，可在程序后跟上脚本的绝对路径）。

虽然上述方法可以实现添加菜单，但实际工作中，我们更需要的其实是个二级菜单，就像图中的“新建”菜单，里面可以包含很多子菜单。

2、在右键菜单中添加二级菜单

1）添加二级菜单数据

在注册表编辑器中找到“HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\CommandStore\shell”，新建子项（例如：importCosUtil），并在其右侧默认数据中设置该二级菜单对应的中文文案（例如：引入腾讯云公共函数）。然后再在importCosUtil下新建子项command，并在其右侧设置要调用的应用程序（图例中我创建了两个二级菜单）；

2）创建一级菜单并与二级菜单建立关联

在“HKEY_CLASSES_ROOT\Directory\Background\shell”下创建子项（例如：前端便捷工具），并在其右侧新建“字符串值”SubCommands，该字符串值对应的数据设置为想要关联的二级菜单的名称（例如：“importCosUtil;importOssUtil;”）；

此时，在文件夹中点击鼠标右键，即可看到自定义的菜单了。

需要注意的是：一级菜单（即示例中的“前端便捷工具”）右侧的默认数据不要做修改，应保持显示“(数据未设置)”，否则当点击鼠标右键时，二级菜单无法显示。

3、编写脚本来添加右键菜单

之前两节都是手动操作注册表，比较繁琐，我们需要编写一个安装脚本，双击运行脚本后自动添加右键菜单。因为注册表的部分内容与业务相关，所以我们结合整体方案思路来说明：

1）使用批处理进行一键安装

设置一个名为install.bat的批处理文件，用来一键安装程序，安装过程中会构建注册表脚本来实现添加右键菜单的操作；

install.bat代码：

node install.js

install.js代码：

const path = require('path');
const Registry = require('winreg');
let nodePath = path.join(process.env.NVM_SYMLINK, 'node.exe');
let copyPath = path.join(__dirname, 'commands', 'copy.js');
const methodToPromise = function (host, method) {
  return new Promise((resolve, reject) => {
    if (!host || !method) {reject('宿主名和方法名不能为空')}
    host[method](function (err) {
      if (err) {reject(err)}
      else {resolve(...arguments)}
    });
  })
}
let ret = (async function () {
  let regKey = new Registry({
    hive: Registry.HKCR,
    key: '\\Directory\\Background\\shell\\前端便捷工具'
  });
  await methodToPromise(regKey, 'create');
  // create方法创建的“(默认)”值不是“(数值未设置)”，需要用clear清空。
  await methodToPromise(regKey, 'clear');
  regKey.set('SubCommands', 'REG_SZ', 'importCosUtil;importOssUtil;', function (err) {
    if (err) {console.log(err)}
  });
  let regKey1 = new Registry({
    hive: Registry.HKLM,
    key: '\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Explorer\\CommandStore\\shell\\importCosUtil'
  });
  let regKey2 = new Registry({
    hive: Registry.HKLM,
    key: '\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Explorer\\CommandStore\\shell\\importOssUtil'
  });
  let regKey3 = new Registry({
    hive: Registry.HKLM,
    key: '\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Explorer\\CommandStore\\shell\\importCosUtil\\command'
  });
  let regKey4 = new Registry({
    hive: Registry.HKLM,
    key: '\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Explorer\\CommandStore\\shell\\importOssUtil\\command'
  });
  // let regVal3 = "\"\\\"C:\\Users\\Administrator\\AppData\\Roaming\\nvm\\v10.4.1\\node.exe\\\" \\\"E:\\public\\commands\\copy.js\\\" cosUtil.js \\\"%V\\\"\"";
  let regVal3 = `\"\\\"${nodePath}\\\" \\\"${copyPath}\\\" cosUtil.js \\\"%V\\\"\"`;
  let regVal4 = `\"\\\"${nodePath}\\\" \\\"${copyPath}\\\" ossUtil.js \\\"%V\\\"\"`;
  await methodToPromise(regKey1, 'create');
  await methodToPromise(regKey2, 'create');
  await methodToPromise(regKey3, 'create');
  await methodToPromise(regKey4, 'create');
  regKey1.set(Registry.DEFAULT_VALUE, 'REG_SZ', '引入腾讯云公共函数', function (err) {console.log(err)});
  regKey2.set(Registry.DEFAULT_VALUE, 'REG_SZ', '引入阿里云公共函数', function (err) {console.log(err)});
  regKey3.set(Registry.DEFAULT_VALUE, 'REG_SZ', regVal3, function (err) {console.log(err)});
  regKey4.set(Registry.DEFAULT_VALUE, 'REG_SZ', regVal4, function (err) {console.log(err)});
})();

上述代码中，我是通过“winreg”这个依赖包来操作注册表的，因为操作注册表需要管理员权限，所以要以管理员身份运行批处理。

其中一个难点在regVal3和regVal4的内容上，需要多层字符转义。其最终写入注册表的内容是：

"C:\Users\Administrator\AppData\Roaming\nvm\v10.4.1\node.exe" "e:\public\commands\copy.js" cosUtil.js "%V"

2）点击右键菜单时的响应脚本

当点击右键菜单时，系统会执行注册表command项中设置的命令，此处以“引入腾讯云公共函数”为例，command内容为

"C:\Users\Administrator\AppData\Roaming\nvm\v10.4.1\node.exe" "E:\public\commands\copy.js" cosUtil.js "%V"

意即点击菜单后会执行copy.js这个本地脚本（将某个公共函数库拷贝到当前文件夹中）。

copy.js代码：

const fs = require('fs');
const path = require('path');
const toolsNode = require('../libs/tools-node');
// 获取传递给脚本的参数（排除前两个默认参数）
const args = process.argv.slice(2);
let from = path.join(__dirname, '../resources/', args[0]);
let to = path.join(args[1], args[0]);
if (fs.existsSync(from) && fs.existsSync(args[1])) {
  toolsNode.copyFile(from, to);
}

完成上述代码后，直接以管理员身份运行install.bat便可以自动添加右键菜单了。