microsoft .net sdk 是什么

入门与上手

讲清 microsoft .net sdk 由哪些部分组成、为什么装一个就够用,以及装完怎么验证、多版本怎么共存。

很多人第一次在 Windows 上装 .NET,会看到 Runtime、Desktop Runtime、SDK 好几个下载项,不知道该点哪个;装完在命令行敲 dotnet 又报找不到命令。这篇不聊具体版本号,只说 SDK 里装了什么、和 Runtime 差在哪、装完按哪几步自检,以及多版本并存时怎么确认自己当前用的是哪一个。

很多人第一次在 Windows 上装 .NET,打开下载页看到 Runtime、Desktop Runtime、SDK 好几个选项,不知道该点哪个,随手装了看起来最像的那个,结果在命令行敲 dotnet 时提示找不到命令。这不是手气问题,是选错了包。

这篇不聊具体版本号,只说清 SDK 这套东西里装了什么、和 Runtime 本质差在哪、装完按哪几步自检,以及一个机器上同时存在多个版本时,怎么确认你当前用的到底是哪一个。

SDK 到底是什么:一套打包好的工具,不是一个库

SDK 是软件开发工具包的统称,落到 .NET 上,它不是一个能引用的库,而是一整包东西:编译器、命令行工具、项目模板、基础类库加上一份运行时,全都塞在一次安装里。装完之后你既能把源码编译成程序,也能直接把程序跑起来,不用再另外找别的组件。

SDK
开发用的一整套,既有造程序的工具,也含跑程序的运行时
Runtime
只管跑已经编译好的程序,不能把源码变成程序
两者关系
SDK 内部本来就包含 Runtime,两个都装不会互相冲突

所以选哪个只看一件事:你手上有没有源码要改。自己写代码、要编译要调试,装 SDK;只负责把别人编译好的程序跑起来,比如部署到服务器,装 Runtime 就够,体积也更小。判断标准很简单,能不能执行 dotnet build,这一条就能区分。

拆开看里面有什么

  • 命令行入口 dotnet:新建项目、还原依赖、编译、运行、发布全都靠它,这是日常打交道最多的东西
  • 编译器与构建目标:把 C#、F# 这些源码编成中间语言,再打包成可执行产物,IDE 和构建脚本底层调的是同一套
  • 模板库:dotnet new 直接生成控制台、Web、类库等骨架,省得手写项目文件
  • 基础类库与运行时:集合、文件、网络、序列化这些常用能力都在里面,起步阶段不引第三方包也能干活

这四块合起来的意思是:你不用单独去下载编译器,不用单独配构建系统,也不用为了跑起来再装一遍运行时。装一次,从写第一行代码到本机运行,链路是完整的。IDE 那边看起来操作更多,实际上也是转手调这套命令行工具,所以命令行玩得明白,出问题时排查会快很多。

装完按这个顺序自检

  1. 确认命令在不在新开一个终端敲 dotnet --version。报「不是内部或外部命令」基本是没进 PATH,或者装完没重开终端,先把终端关了重开再试一次。
  2. 看装了哪些dotnet --list-sdks 和 dotnet --list-runtimes 分别列出 SDK 和运行时,两条命令的输出都对得上,才算装全了。
  3. 跑通最小闭环dotnet new console 建一个空项目,进目录 dotnet run,能打印出结果,说明编译和运行链路都通了,到这一步才算真的可用。
  4. 确认架构对不对同一个机器上 x64 和 arm64 的安装目录是分开的,装错架构常见表现是命令能跑、但构建项目就失败。

这四步的顺序别打乱。很多人一上来就新建项目,构建失败后开始怀疑代码,其实问题可能出在第一步没装全。先确认命令存在,再确认清单完整,最后才验证构建,能省掉大量来回试的时间。想对照常见故障表现,可以到 站内指南中心(/guides) 看相关的排查整理。

多版本共存:别让项目用错版本

一个机器上装多个 SDK 是正常做法,问题在于 dotnet 默认会挑最高的那个来用,而这往往不是你项目需要的那个。版本对不上时,报错通常很含糊,不容易一眼看出是版本的事。

你看到的命令它回答的问题什么时候用
dotnet --version当前目录实际生效的是哪个版本怀疑项目跑错版本时先看它
dotnet --list-sdks这台机器一共装了哪些 SDK排查「是不是根本没装」时用
dotnet --list-runtimes装了哪些运行时,各自什么架构部署报错、架构不符时用

锁版本的做法是:在项目目录下放一个 global.json,把该项目钉到指定版本,团队协作时建议一起提交进仓库,让 CI 和本地用的是同一个。排查顺序也要固定:先在当前目录敲 dotnet --version 看实际生效值,再回头对 global.json,反过来先翻配置文件容易被误导。

什么情况下不用管版本:单人单项目、只做一个玩具工程,锁版本属于过度设计。等到出现「我这能跑、你那不能跑」,或者 CI 和本地结果不一致,再加 global.json,那时它才是解决问题的东西。

什么情况下不该只依赖 SDK

  • 只做部署运维、完全不碰源码的场景,装 Runtime 更轻,额外装 SDK 只是白占空间
  • 需要跨平台产出特定架构产物时,发布参数和目标运行时标识得单独配,光装 SDK 不会自动帮你搞定
  • 团队里版本要求不统一时,靠口头约定没用,要 global.json 加 CI 里显式指定版本一起兜
  • 只是想把一个现成工具跑起来试用,走官方运行时安装包比配整套开发环境快得多

判断是否适用有个简单标准:你有没有「改代码 — 编译 — 再跑」这个循环。有,SDK 就是必需的;没有,只装 Runtime。这个标准在服务器、容器和同事的临时机器上都成立,唯一例外是你打算当场写点脚本验证行为,那还是得回到 SDK。

另外,包体大小、各平台下载项的差异这类数字会随时间变,别照抄别人的经验,到 站内站点目录(/sites) 和价格追踪页核对当时的实际情况更靠谱,尤其是给团队定安装规范之前。

下一步想知道当前的渠道情况和常见坑位,去站内对照一遍再定团队安装规范,比凭印象拍板稳。

常见问题

SDK 和 Runtime 我到底该装哪个?

看你在这台机器上要干什么。要写代码、编译、调试就装 SDK;只是把别人做好的程序跑起来,装对应 Runtime 就够。SDK 里已经包含 Runtime,装了 SDK 就不用再单独装 Runtime,重复装也不会冲突。

命令行提示找不到 dotnet 命令怎么办?

先关掉终端重新开一个,很多情况是装了但当前终端还是旧的环境变量。还不行就去系统的环境变量里确认安装目录有没有加进 PATH。再不行就用绝对路径跑一次,能跑通说明是 PATH 问题,不是安装失败。

同一台电脑装好几个版本的 SDK 会互相影响吗?

不会互相覆盖,它们各自装在自己的目录里。需要注意的是默认行为:不带任何约束时命令行会用版本最高的那个。想让某个项目固定用某个版本,在那个项目目录下放 global.json 指定即可,先看当前生效版本再改配置。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。