C#安装与配置 #

一、开发环境概述 #

C#开发需要安装以下组件：

组件	说明
.NET SDK	开发工具包，包含编译器和运行时
IDE	集成开发环境，如Visual Studio或VS Code
.NET Runtime	运行时环境（SDK已包含）

二、安装.NET SDK #

2.1 Windows安装 #

方式一：官网下载

访问 .NET官网
下载.NET SDK（推荐LTS版本）
运行安装程序

方式二：使用winget

powershell

winget install Microsoft.DotNet.SDK.8

方式三：使用Chocolatey

powershell

choco install dotnet-sdk

2.2 macOS安装 #

方式一：官网下载

访问 .NET官网
下载macOS版本的.NET SDK
运行.pkg安装包

方式二：使用Homebrew

bash

brew install dotnet-sdk

2.3 Linux安装 #

Ubuntu/Debian

bash

wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

sudo apt-get update
sudo apt-get install -y dotnet-sdk-8.0

CentOS/RHEL

bash

sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
sudo yum install -y dotnet-sdk-8.0

Fedora

bash

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo wget -O /etc/yum.repos.d/microsoft-prod.repo https://packages.microsoft.com/config/fedora/37/prod.repo
sudo dnf install -y dotnet-sdk-8.0

2.4 验证安装 #

安装完成后，打开终端验证：

bash

dotnet --version
dotnet --info

输出示例：

text

.NET SDK (8.0.100)
   Usage: dotnet [options]

   Options:
     -h, --help         Show command line help.
     --version          Display .NET SDK version.
     --list-sdks        Display the installed SDKs.
     --list-runtimes    Display the installed runtimes.

三、IDE选择与安装 #

3.1 Visual Studio（Windows/Mac） #

特点：

功能最完整的IDE
智能提示强大
内置调试器
可视化设计器

Windows安装：

下载 Visual Studio
选择Community版本（免费）
勾选".NET桌面开发"工作负载

Mac安装：

Visual Studio for Mac已停止更新，推荐使用VS Code + C# Dev Kit。

3.2 Visual Studio Code（跨平台） #

特点：

轻量级编辑器
跨平台支持
丰富的扩展生态
免费开源

安装步骤：

下载 VS Code
安装C# Dev Kit扩展

推荐扩展：

扩展名称	说明
C# Dev Kit	官方C#开发套件
C#	C#语言支持
.NET Install Tool	.NET安装工具
NuGet Package Manager	NuGet包管理

3.3 JetBrains Rider（跨平台） #

特点：

智能代码分析
强大的重构功能
内置数据库工具
需要付费

四、命令行工具 #

4.1 dotnet CLI #

.NET提供了强大的命令行工具：

创建项目

bash

dotnet new console -n MyFirstApp
dotnet new classlib -n MyLibrary
dotnet new webapi -n MyWebApi
dotnet new mvc -n MyMvcApp
dotnet new blazor -n MyBlazorApp

常用命令

bash

dotnet new console
dotnet build
dotnet run
dotnet publish -c Release
dotnet test
dotnet add package Newtonsoft.Json
dotnet restore
dotnet clean

4.2 项目模板 #

模板	短名称	说明
Console Application	console	控制台应用
Class Library	classlib	类库
Web API	webapi	Web API
ASP.NET Core Web App	mvc	MVC Web应用
Blazor Web App	blazor	Blazor应用
xUnit Test Project	xunit	单元测试项目
Solution File	sln	解决方案文件

五、创建第一个项目 #

5.1 使用命令行 #

bash

mkdir MyFirstApp
cd MyFirstApp
dotnet new console
dotnet run

输出：

text

Hello, World!

5.2 使用Visual Studio #

打开Visual Studio
选择"创建新项目"
选择"控制台应用"
配置项目名称和位置
点击"创建"
按F5运行

5.3 使用VS Code #

打开VS Code
打开终端（Ctrl+`）
执行命令：

bash

dotnet new console -n MyFirstApp
code MyFirstApp

按F5运行

六、项目结构 #

6.1 控制台项目结构 #

text

MyFirstApp/
├── MyFirstApp.csproj
├── Program.cs
└── obj/
    └── ...

.csproj文件

xml

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
</Project>

Program.cs文件

csharp

Console.WriteLine("Hello, World!");

6.2 解决方案结构 #

对于大型项目，使用解决方案组织多个项目：

bash

dotnet new sln -n MySolution
dotnet new console -n MyApp -o src/MyApp
dotnet new classlib -n MyLibrary -o src/MyLibrary
dotnet sln add src/MyApp/MyApp.csproj
dotnet sln add src/MyLibrary/MyLibrary.csproj

七、配置管理 #

7.1 NuGet包管理 #

命令行方式

bash

dotnet add package Newtonsoft.Json
dotnet add package Microsoft.EntityFrameworkCore --version 8.0.0
dotnet remove package Newtonsoft.Json
dotnet list package

Visual Studio方式

右键项目 → 管理NuGet程序包
搜索并安装包

VS Code方式

Ctrl+Shift+P
输入"NuGet"
选择"NuGet Package Manager"

7.2 多目标框架 #

xml

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>net8.0;net7.0</TargetFrameworks>
  </PropertyGroup>
</Project>

八、常见问题 #

8.1 SDK未找到 #

问题： 运行dotnet命令提示找不到SDK

解决：

确认已安装.NET SDK
检查PATH环境变量
重启终端或IDE

8.2 版本冲突 #

问题： 项目要求特定版本SDK

解决：

bash

dotnet --list-sdks

安装所需版本或修改项目目标框架：

xml

<TargetFramework>net8.0</TargetFramework>

8.3 NuGet源问题 #

问题： 无法下载NuGet包

解决：

bash

dotnet nuget list source
dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org

九、开发环境最佳实践 #

9.1 目录结构建议 #

text

MyProject/
├── src/
│   ├── MyApp/
│   └── MyLibrary/
├── tests/
│   └── MyApp.Tests/
├── docs/
├── MyProject.sln
└── README.md

9.2 配置建议 #

启用Nullable引用类型

xml

<Nullable>enable</Nullable>

启用隐式Usings

xml

<ImplicitUsings>enable</ImplicitUsings>

配置代码分析

xml

<EnableNETAnalyzers>true</EnableNETAnalyzers>
<AnalysisLevel>latest</AnalysisLevel>

9.3 推荐设置 #

EditorConfig文件

ini

root = true

[*.cs]
indent_style = space
indent_size = 4
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true

十、总结 #

开发环境搭建要点：

步骤	说明
安装SDK	下载.NET SDK
选择IDE	VS/VS Code/Rider
验证安装	dotnet --version
创建项目	dotnet new console
运行项目	dotnet run

下一步，让我们编写第一个C#程序！