你可能是在装某个工具时被提示「先装 .NET SDK」,也可能是看到项目文件夹里有个 global.json、或者命令行里敲 dotnet 没反应。这篇只解决一件事:这个 SDK 是干嘛的,以及怎么把它干净地装到机器上、装完怎么确认版本对不对。
你可能是在装某个工具时被提示「先装 .NET SDK」,也可能是看到项目文件夹里躺着个 global.json,或者命令行里敲 dotnet 直接没反应。这篇只解决一件事:这个 SDK 到底干嘛用,以及怎么把它干净地装到机器上、装完怎么确认版本是对的。
先说结论:它不是某个编程语言的插件,而是一整套「写代码—编译—运行」的工具箱。名字里虽然还带着 Core,但那已经是历史叫法,现在官方统一叫 .NET,主版本号是纯数字那种。搞不清这一点,很容易照着旧教程装错一条线。
SDK 是什么:一个装完就能干活的工具箱
把 SDK 理解成一个打包好的工作台更合适。它一次给你三样东西:编译工具链、命令行程序 dotnet、外加一份对应的运行时。也就是说,装完 SDK,你既能写、能编译,也能直接跑起来,不用再单独去补运行时。
- SDK
- 工具箱,含编译器和 dotnet 命令,开发机上要装的就是它
- Runtime
- 只负责运行已经编译好的程序,编译不了源码
- dotnet 命令
- SDK 装好后才能在终端里用的主入口,建项目、编译、运行都靠它
两者的差别直接决定你在哪台机器上装什么。开发机必须装 SDK,因为要编译源码;而服务器上如果只是跑已经打包好的程序,装运行时通常就够了,体积小、出问题的面也窄。
- 只有运行时:能跑现成程序,编译时报错说找不到 SDK
- 装了 SDK:编译和运行都能干,但会顺带多装一份运行时
- 版本号差别:.NET Core 已改名叫 .NET,装之前先确认要的是哪条线
- 编辑器自带:某些编辑器或 AI 编程工具内部会打包一份 SDK,和你系统装的可能不是同一份
- 两边打架:内置版本和系统版本不一致,是最常见的坑
怎么装:三条系统的路径,以及装之前先做的两件事
装之前别急着下载。先打开终端,把机器上已有的东西列一遍:敲 dotnet --list-sdks 看装了哪些 SDK,再敲 dotnet --list-runtimes 看运行时。这一步能避免你重复装出一堆版本,后面互相干扰、脚本挑错版本,全是从这里开始的。
| 系统 | 推荐装法 | 要注意的点 |
|---|---|---|
| Windows | 官方安装包或系统包管理器 | 选 x64 还是 arm64 别选错,装完重启终端 |
| macOS | 官方安装包或 brew | 同一条机器别把两种装法混着用 |
| Linux | 按发行版选包管理器或官方脚本 | 混用两种装法最容易出现找不到命令 |
另一个要先看的东西是项目根目录里的 global.json。它会把可用版本锁在一个范围内,系统里版本再新也可能被拒绝。所以团队项目一上手,先翻这个文件,再决定装哪一条线,顺序反了就是白折腾。
- 查已有版本敲 dotnet --list-sdks 和 dotnet --list-runtimes,把清单记下来,确认没有重复或冲突的版本
- 看项目约束打开项目里的 global.json,确认它要求的版本范围,再决定装哪一条线
- 按系统装Windows 和 macOS 走官方安装包或包管理器,Linux 按发行版选一种装法,别混用
- 重启终端关掉当前终端窗口重新打开,让 PATH 生效,否则旧窗口里 dotnet 依然找不到
装完怎么验:三条命令加一个排查顺序
装完先验版本,再验能不能干活。敲 dotnet --version 看当前生效的是哪个,然后和 dotnet --list-sdks 的清单对一遍,确认它挑中的正是你想用的那个。很多「装是装了但没生效」的情况,在这一步就露出来了。
接着新建一个控制台项目并运行一次。能编译、能出结果,说明工具链是通的。只看版本号不跑一遍,等于没验;因为版本对但编译器调不起来的情况,现实中并不少见。想横向看各家运行时和工具链的特点,可以到 工具目录(/tools) 对照着看,站内页面会给出当时的资料。
真出问题的时候,别急着卸载重装。按下面这个顺序查,大多数情况在前两步就能定位。
- PATH 有没有生效:换一个新终端窗口再敲一次命令
- global.json 是否锁版本:把文件里的范围和你装的版本对一下
- 是不是只装了运行时:报找不到 SDK 时优先怀疑这个
- 编辑器缓存要不要清:命令行能跑但编辑器报错,先重启编辑器
- 报错原文:整段贴出来搜,按错误类型归类,别只截最后一行
如果仍然不通,就把完整报错和你的版本清单一起拿出来对照,或者到站内的技术名词页面确认自己卡在哪一层。这里给的是判断顺序,不是万能解;比如企业内网做了源限制、或者系统自带的包管理器版本过旧,这些情况就得换一条安装路径解决。各家官方 API 的价格和最新模型资料,站内也有整理,需要时到 价格追踪(/price-watch) 核对当时的数字。
先列清单再动手,比装完再往回删要省事得多。下一步想知道自己机器上这套环境跑起来大概什么水平、以及常用工具怎么配,可以去站内工具目录和速度测试页各看一圈,照着现有条件选,别盲目堆版本。→
常见问题
SDK 和运行时到底要不要都装?
开发机上装 SDK 就够了,它自带运行时,不必再单独装一遍。部署到服务器那种只跑不编的场景,可以只装运行时,体积更小。唯一要注意的是两边版本别差太远,否则可能出现在本地能跑、上服务器报错的情况。
装完还是提示找不到 dotnet 命令怎么办?
先关掉所有终端窗口重开一个,让 PATH 刷新。还不行就手工确认安装目录有没有进系统环境变量,Windows 上尤其容易漏。多版本共存时用 dotnet --list-sdks 看清单,再用 global.json 指定要用哪个,不要靠改 PATH 顺序去猜。
可以同时装好几个版本吗?会不会冲突?
可以,多版本共存是设计上就支持的,它们装在不同目录,谁生效由 global.json 或当前目录决定。真正会出问题的不是共存,而是版本不匹配的提示被忽略。项目里已经放好 global.json 的话,就按它要求的范围装,别硬升。