VS Code扩展开发中F5调试按键无响应问题求助

我正在按照《你的第一个扩展》官方指南开发VS Code新扩展，但按下F5键后完全没有反应。

系统环境 #

• VS Code版本1.76.0
• Windows 11 x64
• Node版本v18.12.1
• npm版本9.2.0

已排查内容 #

• Node已安装
• Yo-code已安装
• VSCE已安装
• 处于扩展根目录下
• 重启过VS Code
• 参考过Stack Overflow相关问题但未解决

当前配置文件 #

launch.json #

// A launch configuration that compiles the extension and then opens it inside a new window
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Run Extension",
            "type": "extensionHost",
            "request": "launch",
            "args": [
                "--extensionDevelopmentPath=${workspaceFolder}"
            ],
            "outFiles": [
                "${workspaceFolder}/out/**/*.js"
            ],
            "preLaunchTask": "${defaultBuildTask}"
        },
        {
            "name": "Extension Tests",
            "type": "extensionHost",
            "request": "launch",
            "args": [
                "--extensionDevelopmentPath=${workspaceFolder}",
                "--extensionTestsPath=${workspaceFolder}/out/test/suite/index"
            ],
            "outFiles": [
                "${workspaceFolder}/out/test/**/*.js"
            ],
            "preLaunchTask": "${defaultBuildTask}"
        }
    ]
}

tasks.json #

// See https://go.microsoft.com/fwlink/?LinkId=733558
// for the documentation about the tasks.json format
{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "npm",
            "script": "watch",
            "problemMatcher": "$tsc-watch",
            "isBackground": true,
            "presentation": {
                "reveal": "never"
            },
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

package.json #

{
  "name": "xxxxx",
  "displayName": "xxxxx",
  "description": "xxxxx",
  "version": "0.0.1",
  "engines": {
    "vscode": "^1.76.0"
  },
  "categories": [
    "Other"
  ],
  "activationEvents": [],
  "main": "./out/extension.js",
  "contributes": {
    "commands": [
      {
        "command": "xxxxx",
        "title": "Hello World"
      }
    ]
  },
  "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.76.0",
    "@types/glob": "^8.1.0",
    "@types/mocha": "^10.0.1",
    "@types/node": "16.x",
    "@typescript-eslint/eslint-plugin": "^5.53.0",
    "@typescript-eslint/parser": "^5.53.0",
    "eslint": "^8.34.0",
    "glob": "^8.1.0",
    "mocha": "^10.2.0",
    "typescript": "^4.9.5",
    "@vscode/test-electron": "^2.2.3"
  }
}

解决步骤 #

1. 手动触发编译任务
   按下Ctrl+Shift+B执行默认构建任务（即npm run watch），查看终端输出：

   • 若显示Watching for file changes...，说明编译成功，再尝试按F5启动扩展；
   • 若出现编译错误，根据提示修复问题（比如语法错误、依赖缺失）后再重试。

2. 补充激活事件配置
   当前package.json中activationEvents为空数组，会导致扩展无法被激活。添加对应命令的激活事件：

   "activationEvents": [
       "onCommand:xxxxx"
   ]
   

   注意xxxxx要和contributes.commands[0].command的值完全一致。

3. 查看调试日志
   按下F5后，切换到调试控制台和输出面板（选择"Extension Host"输出源），查看是否有报错信息，常见问题包括：

   • 扩展入口文件./out/extension.js不存在（未编译成功）；
   • 依赖模块加载失败。

4. 重置调试配置文件
   删除.vscode/launch.json和.vscode/tasks.json，通过VS Code的"创建launch.json文件"向导重新生成扩展调试配置，确保参数无误。

5. 清理并重装依赖
   在扩展根目录执行以下命令：

   rm -rf node_modules package-lock.json
   npm install
   

   安装完成后执行npm run compile，确保依赖无冲突、编译正常。

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