VS Code调试Excel自定义函数Office加载项断点未绑定报错求助

Yeoman生成器输出的默认调试配置存在已知缺陷，同时多数初学者会混淆自定义函数和任务窗格的运行时环境，选错调试配置，最终触发source map读取失败、断点始终未绑定的问题。

• 修正自定义函数专属调试配置
  打开项目下.vscode/launch.json文件，找到名称为Excel Desktop (Custom Functions)的配置块，删除原有"resolveSourceMapLocations": null配置项，补充以下配置内容：

"sourceMaps": true,
"outFiles": ["${workspaceFolder}/dist/**/*.js"],
"resolveSourceMapLocations": [
  "${workspaceFolder}/**",
  "!**/node_modules/**"
]

注意：Excel自定义函数运行在独立的Node.js运行时中，而非任务窗格所在的WebView环境，Edge/Chrome类的调试配置仅用于调试任务窗格前端代码，无法断点自定义函数的TypeScript逻辑。

• 校验webpack的source map生成规则
  打开项目根目录的webpack.config.js文件，确认开发模式下的devtool字段值为source-map，禁止使用eval、cheap-eval-source-map等eval类的source map选项，否则VS Code无法完成TS源码到编译后JS代码的位置映射。修改配置后，在终端执行npm run build重新生成dist目录下的编译产物和对应map文件。
• 清缓存后重启调试
  1. 关闭所有打开的Excel窗口，通过任务管理器确认没有残留的Excel进程运行
  2. 删除项目根目录下的dist文件夹，以及.vscode目录下自动生成的调试缓存文件
  3. 打开VS Code调试面板，仅选择「Excel Desktop (Custom Functions)」配置启动调试，不要选择其他调试选项
  4. 等待Excel自动启动、加载项旁加载完成后，在单元格内触发一次你编写的自定义函数，原有断点会自动绑定，source map读取报错也会消失。
• 并行调试说明：如果需要同时调试任务窗格的交互逻辑，等自定义函数的调试会话启动完成后，再单独启动「Excel Desktop (Edge Chromium)」调试配置即可，两个调试会话互不干扰，可以分别断点对应运行时的代码。

• 如果启动调试时提示9229端口被占用，在终端执行netstat -ano | findstr "9229"查询占用端口的进程PID，通过任务管理器结束对应进程后再重试。
• 确认你安装的Excel桌面版版本号不低于2108，低于该版本的Office不支持自定义函数的Node.js远程调试能力。
• 调试时不要修改TS源码后手动刷新页面，自定义函数运行时不会自动热更新，改完代码需要停止调试重新启动，否则断点位置会和源码不匹配。

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