C# 与 .NET 环境安装

写 C# 之前,得先装好 .NET SDK。这一篇我们手把手搞定:下载安装、熟悉 dotnet 命令行、创建第一个项目、选一款顺手的 IDE。

一、.NET SDK 是什么?

.NET SDK(Software Development Kit)是开发 C# 必备的全套工具,里面包含三件套:

• .NET 运行时(Runtime):跑 C# 程序用的,包含 CLR、GC、JIT。
• SDK 与编译器:把 .cs 源码编译成 IL(中间语言)。
• dotnet CLI:命令行工具,创建/编译/运行/打包项目。

只要装了 SDK,运行时、编译器、CLI 都齐了,不缺任何东西。安装包免费、开源,大小约 200MB。

二、安装 SDK

三个平台都支持,推荐用包管理器,卸载方便:

# Windows: 从 dot.net 下载 .NET SDK 安装包,双击安装
# 或用 winget(Windows 包管理器):
winget install Microsoft.DotNet.SDK.9

# macOS: 推荐用 Homebrew
brew install --cask dotnet-sdk

# Linux(Ubuntu/Debian):
sudo apt-get update
sudo apt-get install -y dotnet-sdk-9.0

# 验证安装成功
dotnet --version
# 输出类似: 9.0.100

装好后dotnet --version能输出版本号就说明成功了。建议装最新的 LTS 版本(目前是 .NET 8)或 STS 版本(目前是 .NET 9)。本系列示例代码在 .NET 8 及以上均能运行。

三、第一个项目:Hello World

.NET 用 dotnet new 命令创建项目,基于项目模板。最基础的控制台程序:

# 创建一个控制台项目,名字叫 Hello
dotnet new console -o Hello

# 进入项目目录
cd Hello

# 项目自动生成的文件:
# Hello.csproj   项目文件(指定 SDK、目标框架)
# Program.cs     主程序入口(已带 Hello World 模板)

# 运行项目
dotnet run
# 输出: Hello, World!

看到"Hello, World!"输出就说明环境完全 OK。打开 Program.cs 看一眼默认代码,然后改成自己的:

// 默认生成的 Program.cs(C# 9+ 顶级语句)
Console.WriteLine("Hello, World!");

// 改成自定义输出
Console.WriteLine("你好,我是 C#");
Console.WriteLine("今天开始学 .NET");

再 dotnet run 一次,输出就会变成你写的内容。这就是 C# 的"开发循环":改代码 → 保存 → 运行。

四、.csproj 项目文件

每个 .NET 项目都有一个 .csproj 文件(XML 格式),它告诉 SDK 怎么编译:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net9.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

</Project>

几个关键节点:

• OutputType:输出类型。Exe 是可执行程序,Library 是类库。
• TargetFramework:目标框架。net9.0 表示 .NET 9。还能写 net48(老 Framework)做多目标。
• ImplicitUsings:自动 using 常用命名空间,省得每个文件写一堆。
• Nullable:开启可为空引用类型检查,C# 8+ 重要特性。

五、常用的 dotnet 命令

• dotnet new <模板>:创建项目。常用模板有 console(控制台)、webapi(Web API)、webapp(Razor Pages)、classlib(类库)。
• dotnet build:只编译不运行,检查语法错误。
• dotnet run:编译并运行(开发阶段最常用)。
• dotnet add package <名>:安装 NuGet 第三方包,如 dotnet add package Newtonsoft.Json。
• dotnet test:跑单元测试项目。
• dotnet publish:发布可部署的二进制(下文细讲)。
• dotnet --info:看本机装了哪些 SDK 和运行时。
• dotnet --list-sdks:列出所有已装 SDK。

六、发布程序给别人用

开发完代码,要打包给别人用,就用 dotnet publish:

# 发布为可执行文件(包含 .NET 运行时,无需目标机器装环境)
dotnet publish -c Release -r win-x64 --self-contained
# 输出在: bin/Release/net9.0/win-x64/publish/

# 不带运行时(目标机器需装 .NET)
dotnet publish -c Release --no-self-contained

# 单文件打包(部署友好)
dotnet publish -c Release -r linux-x64 --self-contained -p:PublishSingleFile=true

两个关键选项:--self-contained 把 .NET 运行时一起打包,目标机器不需要装 .NET(包大,~70MB);不加则目标机器必须装运行时(包小,几 MB)。单文件 PublishSingleFile 把所有 DLL 打成一个 exe,部署体验更好。

七、IDE 与编辑器选哪个?

写 C# 的工具选择非常多,挑顺手的即可:

• Visual Studio 2022+(Windows/Mac):微软亲儿子,功能最全(调试、重构、设计器),Community 版免费。新手首选。
• VS Code + C# Dev Kit 扩展:跨平台轻量,启动快,远程开发友好。功能不如 VS 全,但日常够用。
• JetBrains Rider:商业产品,基于 IntelliJ 平台 + ReSharper,功能强、性能好。个人有免费版(非商业用途)。
• Visual Studio Code 用 .NET Core 工具链:命令行 + 编辑器组合,适合熟练开发者。

本教程示例推荐 VS Code + C# Dev Kit:跨平台、轻量、对 dotnet CLI 友好。装好后打开项目文件夹,按 F5 即可调试运行。

八、调试与小技巧

• 断点:编辑器行号左侧点击设置断点,运行到此处暂停。
• 监视变量:调试时悬停变量看值,或加到 Watch 面板。
• 逐语句 F11 / 逐过程 F10:控制单步执行。
• hot reload:运行中改代码立即生效,不用重启。dotnet watch 命令可启用。
• 格式化文档:VS Code 默认 Shift+Alt+F,VS 是 Ctrl+K Ctrl+D。

九、常见问题

• 找不到 dotnet 命令?:大概率是 PATH 没刷新,重启终端或注销重登。
• Mac 上首次运行被拦截?:System Settings → Privacy & Security → 允许 dotnet。
• Linux 上 SSL 报错?:装 ca-certificates 包。
• 同时装多个 SDK 会冲突吗?:不会,新版 SDK 兼容旧目标框架。项目用哪个看 csproj。
• 能离线开发吗?:第一次还原依赖需要联网,之后纯本地开发即可。

小结

到这里你的 C# 开发环境就齐了:SDK 装好、CLI 会用、IDE 选好、第一个 Hello World 跑通。下一篇我们正式进入语法部分——C# 程序的整体结构、using、命名空间、注释。

← 上一篇 C# 语言简介

下一篇 C# 基础语法 →