2. 安装 .NET 10 SDK 与开发环境

本节目标：在电脑上装好 .NET 10 SDK，跑通验证命令，并搭起能写代码、能运行的最小环境。

写代码不需要先买昂贵的软件。C# 的整套开发工具都是免费开源的，这是它相比很多老牌商业语言最友好的地方。这一章带你把环境一次装对，避免后面卡在”命令找不到”这种低级问题上。环境装好了，后面每一章你都能亲手把代码跑起来验证。

先搞懂：.NET 到底是什么

在装之前，先弄清楚我们到底在装什么。很多人把 ”.NET” “C#” “SDK” 混为一谈，其实三者各司其职：

C# 是一门编程语言，是你写的那一行行代码。
.NET 是一个大平台，包含两样东西：一个是运行时（Runtime，负责真正执行程序），另一个是基础类库（Base Class Library，一堆现成的功能，比如读写文件、做数学运算）。
SDK 是给写代码的人用的”全套工具箱”，里面有编译器、运行时，还有 dotnet 这一组命令。

打个比方：C# 是你写的乐谱，.NET 运行时是乐队，SDK 则是作曲+排练+演出的整套设备和人员。你写程序，靠的是这一整套，不是单独一个零件。

Note

C# 和 .NET 由微软主导，但早已开源（仓库在 GitHub 的 dotnet/runtime、dotnet/roslyn）。所以无论你用什么系统，都能免费拿到官方工具，不用找破解版。

先装什么：SDK 而非运行时

你可能会看到两个名词：运行时（Runtime）和 SDK（Software Development Kit）。区别在前面那一段已经埋下伏笔，这里再明确一次：

运行时只负责”跑”已经编译好的程序，是装给最终用户用的。比如你做了个软件发给朋友，他电脑上只需装运行时。
SDK 包含编译器、运行时和一堆命令工具，是给”写程序的人”用的。

我们是要写代码的人，所以永远装 .NET 10 SDK。装了 SDK，运行时自然就带上了，不必分两次装。反过来，只装运行时会缺编译器，你连 dotnet new 都敲不出来。

Tip

去微软官网 dotnet.microsoft.com/download，认准 .NET 10 的 SDK（不是 Runtime，不是 Preview）。LTS 版本最稳，资料也最多，本教程就锁定它。

LTS 还是 STS：版本怎么选

下载页上你会看到 LTS 和 STS 两种标记，这是理解”该装哪个”的关键：

LTS（Long Term Support，长期支持）：大版本号是偶数的（.NET 6、8、10…），微软提供约三年的更新与安全修复，追求稳定，企业最爱。
STS（Standard Term Support，标准支持）：奇数版本（.NET 7、9…），只支持约一年半，适合想抢先用新特性的尝鲜者。

本教程选 .NET 10（LTS），因为它稳定、支持久、教程和社区答案最多。新手不需要追 STS 的新，把基础打在 LTS 上最划算。记住：SDK 版本号（如 10.0.302）和你写的 C# 语言版本是对应的——装了 .NET 10 SDK，你默认就拥有 C# 14 的全部语法。

Warning

别把”SDK 版本”和”运行时版本”搞混。装 SDK 后 dotnet --version 显示的是 SDK 版本（如 10.0.302）；真正运行程序时调用的运行时是另一套号。学习阶段只需盯紧 SDK 版本≥10 即可。

Windows 上安装

打开下载页，选 Windows 对应的 SDK 安装包（x64 最常见，Arm 机器选 Arm64）。
双击运行，一路”下一步”即可，无需改任何设置。
安装完成后，不要急着打开图形界面，先验证命令行——那是”真相”。

macOS 与 Linux 上安装

macOS 用户下载 pkg 包双击安装；Linux 用户（以 Ubuntu 为例）通常用官方提供的脚本或 apt 源。核心命令长这样：

# 下载并运行微软提供的安装脚本（以常见发行版为例）
wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh --channel 10.0

不同发行版细节略有差异，官网有分步指南。无论哪种系统，装完都请打开”终端”验证。

验证安装：dotnet —version

打开命令行（Windows 用 PowerShell 或命令提示符，mac/linux 用终端），输入：

dotnet --version

如果看到类似 10.0.302 这样的版本号，说明 SDK 装好了。这个数字就是本教程的基线 SDK 版本。

顺手再用两条命令看看本机装了哪些东西，以后排错用得上：

# 列出本机所有已安装的 SDK 版本
dotnet --list-sdks

# 查看更详细的运行环境信息
dotnet --info

dotnet --list-sdks 会列出所有 SDK；dotnet --info 则把运行时、装在哪里、什么架构都打印出来。机器上版本多、路径乱时，这两条能帮你快速定位。

Note

如果提示”dotnet 不是内部或外部命令”，通常是安装未把路径写进环境变量。Windows 可重启终端或重装；macOS/Linux 需把 dotnet 路径加进 shell 配置文件。遇到这种错别慌，这是环境配置问题，不是你写错了。

选编辑器：Visual Studio 还是 VS Code

有了 SDK，理论上用记事本都能写。但没人这么干——我们需要代码补全、报错提示、一键运行。两个主流选择：

Visual Studio（Windows / macOS）

微软官方的”全家桶” IDE（集成开发环境，Integrated Development Environment）。功能最全，调试体验最好。个人学习用 Community 社区版，免费且够用。缺点：安装包几个 G，仅支持 Windows 和 macOS。

Visual Studio Code + C# Dev Kit（全平台）

VS Code 是轻量编辑器，装一个官方 C# Dev Kit 插件后，就能获得智能提示、调试、项目管理。体积小、启动快，三大系统通吃。缺点：高级功能需自己配插件。

Tip

新手怎么选？用 Windows 想省心 → Visual Studio Community；用 macOS/Linux 或想要轻量 → VS Code + C# Dev Kit。本教程的示例都用命令行运行，两种编辑器都能直接照搬。

命令行工作流初体验

装好之后，我们用三条命令体验”新建—运行”的循环，这也是你之后最常用的节奏：

# 1. 新建一个控制台项目（console 是命令行程序模板）
dotnet new console -o HelloWorld

# 2. 进入项目目录
cd HelloWorld

# 3. 编译并运行
dotnet run

dotnet new console 会生成一个最小项目；-o HelloWorld 指定文件夹名。dotnet run 会自动编译并启动程序，屏幕上出现 Hello, World! 就成功了。

Note

-o 是 output（输出目录）的缩写。如果省略，项目会建在当前文件夹。初学建议带上 -o，目录更干净。除了 console，dotnet new 还能建 classlib（类库）、webapi 等模板，后面需要时再认识。

新手常踩的坑

装成 Runtime 而非 SDK：结果没有 dotnet new 等命令。重装 SDK 即可。
版本老旧：系统里若残留旧 .NET，可能 dotnet --version 显示老数字。可在项目里用 dotnet --version 确认全局，新项目默认用装好的 10。
路径带中文或空格：项目目录尽量用英文，避免编译时找不到文件。
杀软/网络盘拖慢：项目放在本地磁盘，别放 OneDrive、网络映射盘，否则首次 dotnet run 可能慢得离谱。

没有网络时能装吗

官方安装包需要联网下载。如果环境受限，有两个思路：

离线安装包：微软提供可缓存的离线 SDK 包，提前在有网机器下好带走。
全局安装 VS：Visual Studio 安装时勾选”.NET 桌面开发”，会把配套 .NET 运行时一并装上，适合只用这一台机器的人。

但绝大多数情况，直接联网下 SDK 最省事。装之前确认磁盘有至少 1–2 GB 余量，避免中途空间不足。

验证编辑器是否”连通”了 SDK

编辑器装好后，最好验证它能找到 dotnet。在 VS Code 里打开任意 .cs 文件，看右下角是否显示 C# 语言服务已激活；在 Visual Studio 里新建”控制台应用”模板，能直接按 F5 运行即说明链路通了。

如果编辑器报”找不到 .NET”，多半是装了 SDK 但没重启终端/编辑器。重启一次通常就好。

Note

编辑器只是”写字的地方”，真正编译运行靠的是 dotnet 命令。哪怕编辑器没配好，只要命令行 dotnet --version 正常，你就能用记事本写、命令行跑，不影响学语法。

合适该重装或升级

环境不用频繁动，但几种情况值得考虑升级：

教程或库要求更高 SDK（比如别人代码用了 C# 14 新语法，你却是 .NET 9）。
当前 SDK 过了支持期，有安全更新。
想体验某个刚发布的新特性。

升级很简单：再跑一遍安装程序装新 SDK 即可，旧版本会保留，互不影响。.NET 支持多版本并存，这点比很多语言省心。

常见疑问解答

问：装 SDK 时提示”已存在更高版本”要紧吗？ 不要紧。.NET 允许多个版本并存。只要 dotnet --version 能显示 10.x，你就能用本教程的语法。旧版本留着不影响新项目。

问：必须用命令行吗？图形界面不香吗？ 命令行是”看得见的真相”：每一步都明确发生了什么，报错也最直白。初学者用命令行建立直觉，之后再切图形界面会非常顺。两者最终殊途同归。

问：公司电脑不能装软件怎么办？ 可让 IT 协助装 .NET 10 SDK；或用 VS Code 的远程开发、在线环境替代。核心是要有一处能 dotnet run 的地方。

问：我装了 SDK 还需要单独装 C# 编译器吗？ 不需要。编译器（csc）已经打包在 SDK 里，dotnet 命令帮你调用它。你从不会直接手敲 csc，交给 dotnet run / dotnet build 就行。

要点速记

C# 是语言，.NET 是平台（运行时+类库），SDK 是写代码的全套工具。
写代码装 SDK（不是 Runtime），验证用 dotnet --version。
选 LTS（.NET 10）最稳；dotnet --list-sdks / dotnet --info 帮你看清装了啥。
编辑器二选一：Windows 用 Visual Studio Community，跨平台用 VS Code + C# Dev Kit。
黄金工作流：dotnet new console → dotnet run。
项目目录尽量用英文，避开中文与空格。

小结与下一步

你已经拥有能写能跑的完整环境：.NET 10 SDK 提供编译器与命令，编辑器负责写得舒服。记住那条黄金命令 dotnet run，后面会天天见。顺手记牢”SDK 包含一切、LTS 最稳”这两个判断，以后选版本就不纠结。

下一章，我们真正写出第一行 C# 代码，并弄明白”顶级语句”这个新写法。