VSCode扩展：能否通过MarkdownString链接向命令传递参数？

问题场景 #

开发VSCode扩展时，通过HoverProvider返回带自定义命令链接的MarkdownString，命令能正常触发，但无法传递参数到命令函数中。

错误原因分析 #

1. 命令ID不统一：package.json中声明的命令ID是hover-command.say_hello，但代码中注册命令和Markdown链接里用的是say_hello，缺少扩展前缀，导致命令匹配异常。
2. 参数传递格式错误：MarkdownString中命令的参数不能用URL查询字符串（?hi=world）格式，VSCode要求参数需序列化为JSON数组并编码后拼接在命令ID后。

修正步骤及代码 #

1. 统一命令ID #

确保命令注册、Markdown链接与package.json中的ID完全一致：

修正后的package.json（关键部分）

{
  "name": "hover-command",
  // 省略其他代码
  "contributes": {
    "commands": [
      {
        "command": "hover-command.say_hello",
        "title": "greetz"
      }
    ]
  }
}

2. 正确注册命令 #

使用完整的命令ID注册，并确保参数接收逻辑正确：

修正后的extension.ts命令注册部分

context.subscriptions.push(
  vscode.commands.registerCommand("hover-command.say_hello", async (hi: string) => {
    vscode.window.showInformationMessage(`${hi} greetz at ${new Date()}`);
  })
);

3. 修正MarkdownString的命令链接格式 #

将参数序列化为JSON数组并URL编码，正确拼接在命令ID后：

修正后的extension.ts HoverProvider部分

const selector: vscode.DocumentSelector = {
  scheme: "file",
  language: "*",
};

vscode.languages.registerHoverProvider(selector, {
  provideHover(
    doc: vscode.TextDocument,
    pos: vscode.Position,
    token: vscode.CancellationToken
  ): vscode.ProviderResult<vscode.Hover> {
    // 序列化参数为JSON数组并编码
    const params = encodeURIComponent(JSON.stringify(["world"]));
    const hoverMarkup = `[Greetings...](command:hover-command.say_hello?${params})`;
    
    const mdstring = new vscode.MarkdownString(hoverMarkup);
    mdstring.isTrusted = true; // 执行命令必须设置此项
    return new vscode.Hover(mdstring);
  },
});

补充说明 #

• 若需传递多个参数，只需在JSON数组中添加对应值即可，例如JSON.stringify(["param1", "param2", 123])
• 必须设置mdstring.isTrusted = true，否则VSCode会阻止命令执行

内容的提问来源于stack exchange，提问作者toetag