适用范围与准备
适用于Windows上的客户端启动前明确出现“You must install .NET”或“You must install or update .NET”一类提示。先核对程序来自正式发布渠道并完整解压,保留配置;不能因为某个旧包打不开,就认定所有代理软件都需要同一种运行库。
先区分原因
依赖系统运行时的.NET应用需要找到匹配的框架、版本和架构。Microsoft.NETCore.App与Microsoft.WindowsDesktop.App不是同一个框架;仅安装普通.NET Runtime,不一定满足Windows桌面框架需求。系统已有更高大版本也不自动保证旧应用兼容。
按顺序操作
- 记录启动错误里的Framework、Version、Architecture和.NET location等实际字段,连同安装包版本一起保存。若提示是缺少DLL、签名拦截或损坏文件,而没有明确.NET信息,先按那个错误查,不套用本文安装组件。
- 对照应用该版本的官方要求。若缺少Microsoft.WindowsDesktop.App,核对Windows Desktop Runtime;若缺的是其他框架,则选包含它的对应运行时。正常运行应用不必为了凑齐组件先安装整套SDK,也不要把.NET Framework 4.x与现代.NET运行时混为一谈。
- 在已经可调用dotnet的终端中执行下方只读查询,查看当前找到的宿主和运行时列表。若命令找不到,只能说明当前终端没有找到dotnet,不能断言所有架构和位置都未安装;错误页列出的查找位置仍需一起核对。
- 从Microsoft官方下载入口按应用要求选择框架、兼容版本和错误中标明的架构,安装前核对设备权限与支持范围。x64、x86和Arm64要按应用实际要求区分;不要仅凭电脑是64位就忽略应用架构,也不要删除已有运行时来“只留最新版”。
- 若旧应用要求已不受支持的依赖,先询问维护者是否有受支持的新版本或合适的自包含包,不盲目补旧依赖。完成必要安装后重开应用,先确认启动错误消失,再独立检查配置、节点和实际请求;运行库安装成功并不提供代理节点。
dotnet --info
dotnet --list-runtimes| 错误或检查项 | 应核对的内容 |
|---|---|
| Microsoft.WindowsDesktop.App | 包含Windows桌面框架的运行时 |
| Framework Version | 应用要求及官方兼容范围,不只看最高大版本 |
| Architecture | 应用需要的x86、x64或Arm64 |
| 终端命令未找到 | 安装位置和PATH可见性,不能直接判未安装 |
| 应用已打开、网页仍失败 | 转查代理配置和网络路径 |
怎样确认有效
重新启动同一个已核实的程序,确认原.NET启动错误消失,并核对它实际显示的版本。运行时列表用于解释环境,不是应用功能验收;下载、订阅和连接还要按对应教程验证。
无效时恢复与下一步
没有改善时保留错误原文与查询结果,核对安装包、架构和查找路径。不要为了回退整批卸载共享运行时;确需卸载本次新增项时先检查其他应用依赖。本文核对Microsoft公开文档,未安装Windows运行时、运行旧客户端或验证特定历史软件兼容性。