如何为VSCode添加自定义悬停提示和文档显示？

yo code

package.json

{
  "name": "my-custom-hover",
  "displayName": "My Custom Hover",
  "description": "Adds custom hover information to VSCode",
  "version": "0.0.1",
  "engines": {
    "vscode": "^1.63.0"
  },
  "categories": [
    "Programming Languages"
  ],
  "activationEvents": [
    "onLanguage:python" // 激活语言
  ],
  "main": "./out/extension.js",
  "contributes": {
    "languages": [
      {
        "id": "python",
        "aliases": [
          "Python"
        ],
        "extensions": [
          ".py"
        ],
        "configuration": "./language-configuration.json"
      }
    ],
    "configurationDefaults": {
      "[python]": {
        "editor.hover.enabled": true
      }
    }
  },
  "scripts": {
    "vscode:prepublish": "npm run compile",
    "compile": "tsc -p ./",
    "watch": "tsc -watch -p ./",
    "pretest": "npm run compile && npm run lint",
    "lint": "eslint src --ext ts",
    "test": "node ./out/test/runTest.js"
  },
  "devDependencies": {
    "@types/vscode": "^1.63.0",
    "@types/glob": "^7.1.4",
    "@types/mocha": "^9.0.0",
    "@types/node": "16.x",
    "@typescript-eslint/eslint-plugin": "^5.9.1",
    "@typescript-eslint/parser": "^5.9.1",
    "eslint": "^8.6.0",
    "glob": "^7.1.7",
    "mocha": "^9.1.3",
    "typescript": "^4.5.4",
    "@vscode/test-electron": "^2.0.3"
  }
}

extension.ts

HoverProvider

import * as vscode from 'vscode';

export function activate(context: vscode.ExtensionContext) {

  let disposable = vscode.languages.registerHoverProvider('python', {
    provideHover(document, position, token) {
      const word = document.getText(document.getWordRangeAtPosition(position));

      if (word === 'my_variable') {
        return new vscode.Hover(`This is a custom hover for the variable 'my_variable'. It stores important data.`);
      }

      if (word === 'my_function') {
        return new vscode.Hover({
          contents: [
            '**My Function**',
            'This function does something special.',
            '```python',
            'def my_function(arg1, arg2):',
            '  # Function implementation',
            '  return result',
            '```'
          ]
        });
      }

      return undefined;
    }
  });

  context.subscriptions.push(disposable);
}

export function deactivate() {}

my_variable

my_function

vscode-languageserver

**

*

\

return new vscode.Hover({
  contents: [
    '**My Function**',
    'This function does something special.',
    '```python',
    'def my_function(arg1, arg2):',
    '  # Function implementation',
    '  return result',
    '```'
  ]
});

vscode.MarkdownString

provideHover(document, position, token) {
  const word = document.document.getText(document.getWordRangeAtPosition(position));
  const line = document.getText(new vscode.Range(position.line, 0, position.line, position.character));

  if (line.includes("my_object.")) {
    return new vscode.Hover(`This is a property of my_object`);
  }

  return undefined;
}

acorn

console.log

launch.json

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "extensionHost",
      "request": "launch",
      "name": "Launch Extension",
      "runtimeExecutable": "${execPath}",
      "args": [
        "--extensionDevelopmentPath=${workspaceFolder}"
      ],
      "outFiles": [
        "${workspaceFolder}/out/**/*.js"
      ],
      "preLaunchTask": "npm: compile"
    }
  ]
}