.NET Interactive 扩展在 VSCode 中的故障排查与修复指南

问题现象

当用户在 VSCode 中使用 .NET Interactive 扩展时，遇到了无法正常启动交互式笔记本的问题。错误日志显示系统无法加载 System.CommandLine 程序集（版本 2.0.0.0），导致内核启动失败。

错误分析

从错误日志中可以观察到几个关键点：

1. 程序尝试加载 System.CommandLine 2.0.0.0 版本失败
2. 错误发生在 Microsoft.DotNet.Interactive.App.Program.Main 方法中
3. 内核进程以非正常退出码 3762504530 终止

根本原因

经过深入排查，发现问题的根源在于 VSCode 设置文件（settings.json）中的配置错误。具体表现为：

• 配置项 dotnet-interactive.kernelTransportArgs 和 dotnet-interactive.notebookParserArgs 中
• 错误地使用了 tools 而不是正确的 tool 命令

解决方案

1. 打开 VSCode 的设置文件（settings.json）
2. 修正以下配置项：

"dotnet-interactive.kernelTransportArgs": [
    "{dotnet_path}",
    "tool",
    "run",
    "dotnet-interactive",
    "--",
    "[vscode]",
    "stdio",
    "--working-dir",
    "{working_dir}"
],
"dotnet-interactive.notebookParserArgs": [
    "{dotnet_path}",
    "tool",
    "run",
    "dotnet-interactive",
    "--",
    "notebook-parser"
]

3. 保存设置并重启 VSCode

技术背景

.NET Interactive 扩展通过 dotnet 工具命令与 VSCode 交互。正确的命令结构应该是：

• dotnet tool run：运行已安装的 dotnet 工具
• dotnet-interactive：.NET Interactive 工具的主程序
• --：分隔符，后面的参数将传递给 dotnet-interactive

预防措施

1. 定期检查扩展配置
2. 在升级扩展后验证基础功能
3. 关注扩展的更新日志，了解配置变更

扩展知识

对于 .NET 工具命令：

• dotnet tool install：安装工具
• dotnet tool run：运行已安装的工具
• dotnet tool list：列出已安装的工具

理解这些基本命令有助于更好地排查类似问题。当遇到工具相关问题时，可以先通过命令行直接运行工具来验证是否正常工作，这能帮助快速定位问题是出在工具本身还是集成环境（如VSCode）中。

总结

配置文件的准确性对于开发工具的正常运行至关重要。即使是简单的拼写错误（如tool/tools）也可能导致功能完全失效。开发者在遇到类似问题时，应该首先检查相关配置项，并与官方文档或已知的正常配置进行对比。