很多人在 Windows 上准备写第一个 C# 程序时,被下载页那一排名字搞懵:Runtime、SDK、Desktop Runtime、ASP.NET Core Runtime,看着都像,装错了要么没有 dotnet 命令行,要么编译直接报「找不到 SDK」。这篇不背版本号,只讲清 SDK 和运行时的分工、装完能拿到什么、遇到多个版本时按什么顺序判断,最后给一套五分钟验证动作。
很多人第一次上 Windows 准备写 C#,打开下载页就懵:Runtime、SDK、Desktop Runtime、ASP.NET Core Runtime 排成一排,名字看着都差不多。手一抖装成 Runtime,结果终端里敲 dotnet 一点反应没有,或者编译时直接甩一句「找不到 SDK」。这篇不背版本号,只把 SDK 和运行时的分工讲清楚,再说装完之后怎么自己验证,遇到多个版本按什么顺序判断。
一句话先记住:SDK 是能让你「从零写出一个程序」的那套东西,Runtime 是「把别人写好的程序跑起来」的那套东西。下面拆开讲,每节都给你能当场动手的动作。
一句话说清:SDK 是「工具箱+运行底座」
SDK 里同时装着命令行工具、编译器、项目模板和运行时。所以装完 SDK,你就能 dotnet new 建项目、dotnet build 编译、dotnet run 直接跑,一条龙。而只装 Runtime 的机器,只能运行别人已经编好的程序,自己动手编就会卡住。它本质上不是个带界面的软件,装完往往看不到图标,验证方式就是打开终端敲命令。
- 命令行工具
- dotnet new / build / run / publish 这些命令的来源,没有它就没法在终端操作项目
- 编译器
- 把 C# 代码翻译成能执行的程序,这一步是「写代码」和「只跑程序」的分水岭
- 模板
- 控制台、Web、类库等项目的初始骨架,省得你从空文件夹手搓
- 运行时
- 程序真正跑起来时需要的底座,SDK 里自带一份,不用另外装
还有一点容易忽略:它管的是「语言和平台」这一层,跟你用哪个编辑器没关系。VS Code、Visual Studio、Rider 都只是外壳,真正干活的是系统里那套 dotnet。换句话说,SDK 决定你能不能编译、能编译成什么、能跑在哪些系统上;编辑器只决定你打字舒不舒服。
SDK 和 Runtime 到底差在哪,什么时候只装后者
判断标准一条就够:这台机器上要不要写代码或者编译代码。要写、要编,就装 SDK;纯部署运行,装 Runtime 就行,体积还小。这个判断放到服务器和容器里同样成立——线上环境通常只装 Runtime,因为不需要现场编译;但如果你在容器里跑 CI 构建,那一步用的镜像必须带 SDK,否则构建脚本第一步就挂。
| 场景 | 装哪个 | 原因 |
|---|---|---|
| 本机写代码、调试 | SDK | 要编译、要模板、要 CLI |
| 服务器跑已发布程序 | Runtime | 只运行,不需要编译 |
| 容器里做 CI 构建 | SDK | 构建阶段要编译 |
| 跑桌面程序(如 WinForms) | Desktop Runtime | 缺它会提示缺少框架 |
常见坑是「装了运行时还是没有 dotnet 命令」。这不是装坏了,Runtime 本来就不带 CLI。还有人把桌面程序报的「缺少框架」当成 SDK 没装,其实那是运行时的事。名字里带 Runtime 的,基本都是管跑的;带 SDK 的,才是管写的。
- 不确定装没装:先敲 dotnet --info,没反应就是没装或没进 PATH
- 不确定装了啥:敲 dotnet --list-sdks 看清单
- 服务器部署:默认按 Runtime 规划,别顺手装全套
- CI 构建步骤:镜像必须带 SDK,否则编译命令直接失败
- 桌面程序报缺框架:检查是不是 Runtime 那一侧的事,别乱重装 SDK
面对一堆版本号,按这个顺序挑就不会错
先看你项目的目标框架。工程文件里声明的哪个大版本,就装那个大版本对应的 SDK,跨大版本编译失败很常见。再看项目类型:如果工程用了新语法或新模板,老 SDK 会直接报不支持,这时候不是去改代码,而是把 SDK 升上去。同一台机器可以并存多个大版本 SDK,用 global.json 锁定项目用哪个。
- 先查项目声明打开工程文件,看目标框架写的是哪个大版本,这是选 SDK 的第一依据
- 再对机器清单敲 dotnet --list-sdks,比对申明版本有没有落在清单里
- 多版本并存别慌并存本身没问题,真正要防的是无意间切错版本,用 global.json 固定住
- 查支持情况具体有哪些受支持版本、支持到什么时候,到站内 /stacks/atlas 核对当时的数字,别凭记忆
- 陌生术语对照遇到没见过平台名词,去 /ai-dict/category/tech 顺着查一遍
「装了新版会不会冲突」不是主要顾虑,多版本共存是设计好的行为。别把精力花在纠结版本号大小上,把「项目声明什么、机器装了什么」这两件事对齐就够了。真要知道当前哪些版本还在支持期,去站内页面看当时的数字。
装完之后的五分钟自检清单
装完别急着打开编辑器建项目,先在终端跑一遍下面这套动作。这四步能覆盖绝大多数「装了却用不了」的情况,顺序也别乱,前面的过不了,后面查了也白查。
- 确认命令在敲 dotnet --info,能打出 SDK 列表和环境信息就说明命令可用;命令不存在就是没装或没进 PATH
- 看清装了哪几个敲 dotnet --list-sdks,把大版本列出来,这一步能立刻暴露「我以为装了其实没装」
- 跑个最小项目找个空目录 dotnet new console,再 dotnet run,跑出结果就说明工具链通了
- 区分安装问题还是版本问题前三步都对但项目仍报错,多半是版本匹配没对上,去比对项目声明的目标框架和机器清单谁缺谁
dotnet --info
dotnet --list-sdks
mkdir demo && cd demo
dotnet new console
dotnet run如果编译错误指向找不到指定框架,先别怀疑安装包下坏了,回头对一遍项目用的版本和机器上有的版本。真要估算时间和机器开销,到 /tools/speed-test 看当时的数字,别拿印象里的结论做决定。
下一步把这套自检命令存成笔记,下次换机器或接手别人环境直接照跑;判断标准、支持情况用站内页面核对当时的数字,比记版本号可靠。→常见问题
我只想运行别人写好的程序,需要装 SDK 吗?
一般不需要。能跑起来靠的是运行时,装 SDK 只是顺带把运行时带进来了,代价是占空间。判断方法很简单:你只说「运行」,不涉及改代码、编译、打包,那就只装运行时。反过来只要你会敲 dotnet build 或 dotnet run,就必须有 SDK。
装了 SDK 之后新建项目报「找不到模板」是怎么回事?
多数是版本太老,模板是随 SDK 一起发的,老版本里没有新项目类型。先 dotnet --list-sdks 看装了哪些版本,再确认你敲的模板名是不是这个版本支持的。还不行就去 /stacks/atlas 把命令和名词对一遍,别急着删重装。
电脑上装了好几个大版本,会不会互相冲突?
默认不会,官方设计就是允许并存,靠 global.json 和项目目标框架决定用哪一个。真正会出问题的是你没锁定版本,换台机器或换个人编译时用了另一个大版本,结果行为不一致。团队项目建议在仓库里放 global.json,把版本固定住。