【Unity 避坑指南】根治VSCode C#插件.NET Runtime循环下载：从settings.json到插件依赖的完整配置

1. 问题重现：为什么.NET Runtime会循环下载？

最近在Unity开发群里看到不少小伙伴吐槽VSCode的C#插件总是自动下载.NET Runtime，明明本地已经安装了却还在不停下载。我自己也遇到过这个问题，刚开始以为是网络问题，后来发现是插件之间的依赖关系没配置好。

这个问题通常表现为：打开VSCode后，右下角不断弹出"Downloading the .NET Runtime"提示，即使你已经按照网上的教程配置了settings.json文件。更糟的是，这个下载经常会失败，导致开发环境无法正常使用。

经过多次测试，我发现主要有两个原因会导致这个问题：

1. OmniSharp插件启用了"Use ModernNet"选项
2. .NET Install Tool for Extension Authors插件没有为所有依赖.NET的插件配置本地路径

2. 基础解决方案回顾

在深入探讨之前，我们先回顾一下基础的解决方法。很多教程会告诉你这样做：

1. 打开VSCode设置（快捷键Ctrl+,）
2. 搜索"omnisharp.usemodernnet"
3. 取消勾选这个选项
4. 然后在.NET Install Tool for Extension Authors插件的设置中添加如下配置：

json复制{
  "dotnetAcquisitionExtension.existingDotnetPath": [
    {
      "extensionId": "ms-dotnettools.csharp",
      "path": "C:\\Program Files\\dotnet\\dotnet.exe"
    }
  ]
}

这个方法确实能解决部分用户的问题，但根据我的经验，大约有30%的情况这个方法无效。这就是为什么我们需要更深入的解决方案。

3. 深入分析插件依赖关系

要彻底解决这个问题，我们需要理解VSCode中C#相关插件的工作原理。目前主流的C#开发插件包括：

• OmniSharp：提供代码补全、导航等基础功能
• C# Dev Kit：微软官方推出的增强开发套件
• Visual Studio Tools for Unity：Unity开发专用插件
• .NET Install Tool for Extension Authors：管理.NET运行时的插件

这些插件都需要.NET Runtime才能运行，但它们之间并不总是能很好地共享运行时。特别是当安装了C# Dev Kit后，问题会变得更加复杂，因为它会强制要求下载特定版本的.NET Runtime。

4. 完整解决方案：配置所有相关插件

经过多次尝试，我发现最可靠的解决方案是为所有可能使用.NET Runtime的插件都配置本地路径。下面是我的完整配置：

json复制{
  "omnisharp.usemodernnet": false,
  "dotnetAcquisitionExtension.existingDotnetPath": [
    {
      "extensionId": "ms-dotnettools.csharp",
      "path": "C:\\Program Files\\dotnet\\dotnet.exe"
    },
    {
      "extensionId": "visualstudiotoolsforunity.vstuc",
      "path": "C:\\Program Files\\dotnet\\dotnet.exe"
    },
    {
      "extensionId": "ms-dotnettools.csdevkit",
      "path": "C:\\Program Files\\dotnet\\dotnet.exe"
    },
    {
      "extensionId": "ms-dotnettools.vscode-dotnet-runtime",
      "path": "C:\\Program Files\\dotnet\\dotnet.exe"
    }
  ]
}

这个配置做了两件事：

1. 完全禁用OmniSharp的ModernNet功能
2. 为所有可能使用.NET的插件指定本地路径

注意：路径中的C:\\Program Files\\dotnet\\dotnet.exe需要根据你实际的.NET安装位置调整。如果你不确定，可以在命令行运行where dotnet查找路径。

5. 验证配置是否生效

配置完成后，我们需要验证是否真的解决了问题。以下是检查步骤：

1. 完全关闭VSCode（包括所有窗口）
2. 重新打开VSCode
3. 打开一个C#项目或Unity项目
4. 观察右下角是否有下载提示
5. 检查输出面板（Ctrl+Shift+U）中OmniSharp和.NET相关的日志

如果一切正常，你应该看不到任何关于下载.NET Runtime的提示，同时所有C#功能（代码补全、错误检查等）都能正常工作。

6. 常见问题排查

即使按照上述方法配置，有时还是会遇到问题。以下是几个常见情况及解决方法：

问题1：配置后仍然提示下载

• 检查是否漏掉了某个插件的配置
• 确保路径完全正确（注意斜杠方向）
• 尝试删除%USERPROFILE%\.vscode\extensions文件夹后重新安装插件

问题2：OmniSharp服务器启动失败

• 检查OmniSharp日志（查看输出面板）
• 尝试手动指定OmniSharp路径：

  json复制{
    "omnisharp.path": "latest"
  }
  

问题3：Unity项目无法正常调试

• 确保Visual Studio Tools for Unity插件已安装
• 检查Unity编辑器中的External Tools设置
• 尝试重新生成项目文件（在Unity编辑器中执行）

7. 进阶配置建议

对于追求更稳定环境的开发者，我建议进一步优化配置：

1. 固定.NET SDK版本：
   在项目根目录创建global.json文件，指定SDK版本：

   json复制{
     "sdk": {
       "version": "6.0.300"
     }
   }
   

2. 使用独立OmniSharp：
   下载OmniSharp独立版本，避免依赖VSCode插件：

   json复制{
     "omnisharp.path": "C:\\path\\to\\omnisharp\\OmniSharp.exe"
   }
   

3. 配置代理（如有需要）：
   如果网络环境特殊，可以配置代理：

   json复制{
     "http.proxy": "http://proxy.example.com:8080",
     "http.proxyStrictSSL": false
   }
   

8. 长期维护建议

为了避免将来再次遇到类似问题，我建议：

1. 定期检查插件更新，但不要立即更新
2. 备份你的settings.json文件
3. 关注VSCode和Unity的官方博客，了解运行时要求的变化
4. 考虑使用VSCode的配置同步功能，保持多台设备配置一致

经过这样全面的配置后，我自己的开发环境已经稳定运行数月没有出现.NET Runtime下载问题。希望这份指南能帮你彻底解决这个烦人的问题，把精力集中在真正的开发工作上。