如何安装NET SDK？

安装 .NET SDK 是开发和运行 .NET 应用程序的基础，支持跨平台（Windows/macOS/Linux），安装后可通过命令行工具 dotnet --info 验证版本信息。

在.NET开发中，csc.exe（C# 编译器）是编译C#源代码文件为程序集（如.exe或.dll）的核心命令行工具，虽然集成开发环境（如Visual Studio）简化了流程，但掌握csc命令行对于理解构建过程、自动化任务或在无GUI环境中工作至关重要,以下是详细设置和使用指南：

下载安装：
- 访问微软官方 .NET 下载页面。
- 选择与你的操作系统（Windows, Linux, macOS）和开发需求（推荐最新的 LTS 或 Current 版本）匹配的 .NET SDK（软件开发工具包）进行下载安装，SDK 包含 csc 编译器、运行时、库和 CLI 工具（如 dotnet 命令）。
验证安装：
- 打开命令提示符 (CMD) 或 PowerShell。
- 输入以下命令之一并按回车：
```
dotnet --version
```
  或
```
csc -version
```
- 如果安装成功，将显示已安装的 .NET SDK 或 csc 编译器的版本号（0.100），如果提示 'dotnet' 不是内部或外部命令... 或 'csc' 不是内部或外部命令...，说明环境变量未正确配置,请继续下一步。

配置环境变量 (PATH)

这是让系统在任何目录下都能识别 csc 命令的关键步骤。

查找 csc.exe 路径：
- Windows (典型路径):
  - .NET SDK 路径通常类似于：C:\Program Files\dotnet\sdk\<version>\
  - csc.exe 的实际位置在 SDK 目录下的 Roslyn\bincore 子目录中，但更常用的是通过 dotnet 命令调用或使用 SDK 目录下的 csc.dll。推荐使用 dotnet 命令或配置开发者命令提示符。
  - 最简单方法： 使用 Visual Studio 附带的 “开发者命令提示符” (Developer Command Prompt)，它已自动设置好所有路径,在开始菜单搜索即可找到。
- Linux/macOS：
  - 安装 .NET SDK 后，dotnet 命令通常已自动添加到 PATH。csc 作为工具链的一部分，可通过 dotnet 调用（见下文“推荐方法”），其物理路径通常在 /usr/share/dotnet/sdk/<version>/Roslyn/bincore/ 或类似位置。
将 .NET SDK 添加到系统 PATH (Windows – 如果必须直接使用 csc.exe)：
- 右键点击“此电脑”或“计算机” -> “属性” -> “高级系统设置” -> “环境变量”。
- 在“系统变量”区域，找到名为 Path 的变量，选中并点击“编辑”。
- 点击“新建”，添加 .NET SDK 的安装目录（C:\Program Files\dotnet\）。注意： 直接添加 csc.exe 的完整路径（如 C:\Program Files\dotnet\sdk\8.0.100\Roslyn\bincore）通常不是最佳实践，添加 SDK 根目录 C:\Program Files\dotnet\ 让系统通过其他机制找到 csc 更可靠，但强烈推荐使用 dotnet 命令或开发者命令提示符。
- 逐级点击“确定”保存更改。
- 重启任何已打开的命令提示符窗口,使更改生效。

使用 csc 命令行编译器

配置好环境后，即可在命令行中使用 csc。

基本编译：
```
csc SourceFile1.cs SourceFile2.cs
```
- 这会编译列出的所有 .cs 文件，并在当前目录生成一个与第一个源文件同名的 .exe 可执行文件（SourceFile1.exe）。
指定输出文件名和类型：
- -out: 指定输出文件名。
- -target: (或 -t:) 指定输出类型：
  - exe：控制台应用程序 (默认)
  - winexe： Windows 窗体应用程序 (无控制台窗口)
  - library：类库 (.dll)
  - module：编译为模块 (.netmodule)
```
csc -out:MyProgram.exe -target:exe Program.cs Utilities.cs
csc -out:MyLibrary.dll -target:library Class1.cs Class2.cs
```
引用程序集：
- -reference: (或 -r:) 引用外部程序集 (.dll)。
```
csc -r:System.Data.dll -r:MyOtherLib.dll Main.cs
```
指定.NET框架版本：
- -langversion: 指定使用的C#语言版本（如 latest, preview, 11, 10 等）。
- -platform: 指定目标平台（如 x86, x64, arm64, anycpu (默认), anycpu32bitpreferred）。
- 更精细的框架目标通常在项目文件中指定，但 csc 也受 -noconfig 和 -nostdlib 等影响。对于现代 .NET (Core 5+)，目标框架由 SDK 隐式管理，通常不需要在 csc 命令中显式指定旧版 .NET Framework。
生成调试信息：
- -debug: 生成调试信息（.pdb 文件）。
  - -debug:full：完全调试信息（默认）。
  - -debug:portable：生成跨平台可移植的 PDB 文件（推荐用于 .NET Core+）。
  - -debug:embedded：将调试信息嵌入到程序集 (.dll/.exe) 中。
```
csc -debug:portable Program.cs
```
其他常用选项：
- -optimize (或 -o)：启用编译器优化（发布版本通常启用）。
- -nullable: 启用或禁用可空引用类型上下文（如 -nullable:enable）。
- -warn: 设置警告等级 (0-4)。
- -nowarn: 禁用特定警告号（如 -nowarn:CS0168）。
- -doc: 生成 XML 文档文件。
- -main: 指定包含入口点 (Main 方法) 的类（当有多个可能的入口点时）。
- -recurse: 递归编译目录中的文件（如 -recurse:*.cs）。
- -nologo：禁止显示编译器版权信息。
- -help (或 )：显示命令行帮助。

推荐方法：使用 dotnet CLI (现代最佳实践)

对于 .NET Core (3.1+) / .NET 5+ 项目，官方推荐使用 dotnet build 和 dotnet publish 命令，而不是直接调用 csc。

dotnet build：

编译项目或解决方案，它会读取项目文件 (.csproj) 中的配置（目标框架、引用、编译器选项等），自动调用 csc 并传递所有必要参数。

用法：

dotnet build [<PROJECT | SOLUTION>] [options]

示例：

dotnet build                  # 编译当前目录的项目
dotnet build MyProject.csproj # 编译指定项目
dotnet build -c Release       # 以 Release 配置编译

dotnet publish：

编译项目并将其依赖项打包到一个目录中,准备部署。
用法：
```
dotnet publish [<PROJECT>] [options]
```

示例：

dotnet publish -c Release -r win-x64 --self-contained true # 发布独立的 Win64 应用

常见问题与解决

'csc' 不是内部或外部命令...：
- 未安装 .NET SDK,请安装。
- .NET SDK 安装路径未正确添加到系统 PATH 环境变量,请检查并添加。
- 未使用 “开发者命令提示符 for VS”,尝试使用它。
编译错误：
- 仔细阅读错误信息，通常包含文件名、行号和错误描述 (如 CSXXXX 错误代码)。
- 检查源代码语法、类型引用、命名空间、文件路径是否正确。
- 确保所有引用的程序集 (-r:) 路径正确且可访问。
找不到引用的程序集：
- 使用 -r: 明确指定程序集的完整路径。
- 确保该程序集已安装或位于可访问的位置，对于 NuGet 包，使用 dotnet CLI (dotnet add package) 或项目文件管理依赖。
生成的程序无法运行 (如缺少依赖)：
- 对于 .exe，确保目标机器安装了相应版本的 .NET Runtime。
- 考虑使用 dotnet publish --self-contained 发布独立应用（包含运行时）。
- 检查引用的 .dll 是否与程序在同一目录或系统能找到的位置。

安装 .NET SDK 是使用 csc 的基础。
配置 PATH 环境变量 或在 Visual Studio 开发者命令提示符 中使用是确保 csc 可用的关键。
掌握 csc 的基本命令（-out, -target, -reference, -debug）对于直接编译很有用。
对于现代 .NET 项目 (Core 3.1+, .NET 5+)，强烈优先使用 dotnet build 和 dotnet publish 命令，它们基于项目文件 (*.csproj) 管理构建过程，自动处理依赖、框架目标、编译器选项等，是更高效、更标准化的方式。
遇到问题时,仔细阅读错误信息并查阅官方文档是首要步骤。