## C# 与 .NET 跨平台开发实战（第一章：开发环境搭建与.NET概述-上篇） ### 引言在当今多平台并行的软件开发世界，跨平台开发已成为刚需。C# 与 .NET 自 2016 年 .NET Core 发布以来，已从仅限 Windows 的封闭生态，进化为支持 Windows、Linux、macOS、容器、移动设备等全平台框架。本文是实战系列的第一章上篇，我们将从零搭建跨平台开发环境，并通过可运行代码理解 .NET 的核心概念。## 环境搭建：选择你的武器### 操作系统与 SDK 安装跨平台开发的第一个挑战是环境一致性。我们使用 .NET SDK 8.0（LTS 版本），它支持以下主流平台：- **Windows** ：从 [dotnet.microsoft.com](https://dotnet.microsoft.com) 下载安装程序，安装后打开命令提示符验证。- **macOS** ：使用 Homebrew (`brew install dotnet-sdk`) 或手动安装。- **Linux (Ubuntu 22.04)** ：通过 Microsoft 仓库安装。安装完成后，在终端执行以下命令确认版本：`bashdotnet --version# 输出示例：8.0.100`### 项目模板创建.NET CLI 是跨平台开发的瑞士军刀。我们创建一个控制台应用来验证环境：`bash# 创建新项目dotnet new console -n HelloWorld# 进入目录cd HelloWorld# 运行项目dotnet run`如果你看到 "Hello, World!" 输出，说明环境搭建成功。## .NET 核心概念：运行时、SDK 与 CLR在编写代码前，理解三个关键组件至关重要：1. **SDK (Software Development Kit)** ：包含编译器、调试器、项目模板等开发工具。2. **Runtime** ：运行已编译 .NET 应用所需的环境，包括 `dotnet` 命令和核心库。3. **CLR (Common Language Runtime)** ：负责执行托管代码、垃圾回收、类型安全等。一个常见误区是认为 .NET 框架等同于 Windows-only。实际上，.NET 8 使用 **CoreCLR** 运行时，它完全跨平台。## 实战代码示例 1：跨平台系统信息采集让我们编写第一个可运行代码，展示 .NET 如何识别当前操作系统并执行平台特定操作。`csharpusing System;using System.Runtime.InteropServices;class Program{ static void Main() { // 获取操作系统描述（跨平台） Console.WriteLine($"当前操作系统: {RuntimeInformation.OSDescription}"); Console.WriteLine($"架构: {RuntimeInformation.OSArchitecture}"); Console.WriteLine($"进程架构: {RuntimeInformation.ProcessArchitecture}"); // 根据平台执行不同操作 if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows)) { Console.WriteLine("检测到 Windows 平台，准备调用 Windows API"); // 这里可以调用 Windows 特有的 COM 组件或 P/Invoke } else if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux)) { Console.WriteLine("检测到 Linux 平台，读取 /etc/os-release"); // 跨平台文件路径处理 string osReleasePath = "/etc/os-release"; if (System.IO.File.Exists(osReleasePath)) { string content = System.IO.File.ReadAllText(osReleasePath); Console.WriteLine($"Linux 发行版信息: {content.Substring(0, 100)}..."); } } else if (RuntimeInformation.IsOSPlatform(OSPlatform.OSX)) { Console.WriteLine("检测到 macOS 平台，使用 Foundation 框架"); // 调用 macOS 特有的 Objective-C 绑定 } // 跨平台环境变量读取 string path = Environment.GetEnvironmentVariable("PATH"); Console.WriteLine($"\n环境变量 PATH (前200字符): {path?.Substring(0, Math.Min(200, path.Length))}"); }}`**运行结果示例（在 Linux 上）：** `当前操作系统: Linux 5.15.0-91-generic #101-Ubuntu SMP Tue Nov 14 13:30:08 UTC 2023架构: X64进程架构: X64检测到 Linux 平台，读取 /etc/os-releaseLinux 发行版信息: PRETTY_NAME="Ubuntu 22.04.3 LTS"...环境变量 PATH (前200字符): /usr/local/sbin:/usr/local/bin:...`这段代码展示了三个跨平台开发要点：- `RuntimeInformation` 类提供平台无关的检测机制- 条件编译 (`#if`) 可以替代运行时检测，但这里我们使用运行时检测来演示灵活性- 跨平台路径处理（Linux 使用正斜杠，Windows 使用反斜杠，但 .NET 的 `Path` 类自动处理）## .NET 项目结构解析使用 `dotnet new` 创建的项目包含：- `Program.cs`：入口文件- `HelloWorld.csproj`：项目文件（XML 格式）- `bin/` 和 `obj/`：编译输出目录（自动生成）在 `HelloWorld.csproj` 中，关键配置如下：`xml Exe net8.0 enable enable `- `TargetFramework` 指定目标框架（`net8.0` 表示 .NET 8）- `ImplicitUsings` 自动引入常用命名空间（如 `System`、`System.IO`）- `Nullable` 启用可空引用类型（现代 C# 特性）## 实战代码示例 2：跨平台文件操作与 JSON 序列化第二个示例演示 .NET 在不同平台下处理文件路径和数据的差异。`csharpusing System;using System.IO;using System.Text.Json;// 定义一个简单的数据模型public class AppConfig{ public string AppName { get; set; } = "MyCrossPlatformApp"; public int MaxThreads { get; set; } = 4; public bool EnableLogging { get; set; } = true;}class Program{ static void Main() { // 1. 跨平台路径构建：使用 Path.Combine 而非字符串拼接 string configDir = Path.Combine( Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "MyApp" ); Console.WriteLine($"配置文件目录: {configDir}"); // 2. 创建目录（跨平台） Directory.CreateDirectory(configDir); string configFile = Path.Combine(configDir, "config.json"); // 3. 序列化配置对象为 JSON var config = new AppConfig { AppName = "跨平台演示应用", MaxThreads = Environment.ProcessorCount, // 动态获取CPU核心数 EnableLogging = true }; string json = JsonSerializer.Serialize(config, new JsonSerializerOptions { WriteIndented = true }); // 4. 写入文件 File.WriteAllText(configFile, json); Console.WriteLine($"配置已保存至: {configFile}"); // 5. 从文件读取并反序列化 if (File.Exists(configFile)) { string readJson = File.ReadAllText(configFile); AppConfig loadedConfig = JsonSerializer.Deserialize(readJson); Console.WriteLine($"\n读取的配置:"); Console.WriteLine($" 应用名: {loadedConfig.AppName}"); Console.WriteLine($" 最大线程数: {loadedConfig.MaxThreads}"); Console.WriteLine($" 日志启用: {loadedConfig.EnableLogging}"); } // 6. 演示跨平台路径分隔符 Console.WriteLine($"\n路径分隔符: {Path.DirectorySeparatorChar}"); Console.WriteLine($"在 Windows 上为 \\，在 Linux/macOS 上为 /"); }}`**运行结果示例（在 macOS 上）：** `配置文件目录: /Users/username/AppData/Roaming/MyApp配置已保存至: /Users/username/AppData/Roaming/MyApp/config.json读取的配置: 应用名: 跨平台演示应用最大线程数: 8 日志启用: True路径分隔符: /在 Windows 上为 \，在 Linux/macOS 上为 /`## 总结本文从实战角度完成了跨平台开发的第一步：1. **环境搭建** ：成功安装 .NET SDK 并验证了 `dotnet run` 命令。2. **核心概念** ：理解了 SDK、Runtime、CLR 的职责，以及 .NET 8 的跨平台本质。3. **代码实战** ：通过两个可运行示例，展示了平台检测、文件路径处理、JSON 序列化等核心技能。跨平台开发的关键在于**使用 .NET 的抽象层** （如 `RuntimeInformation`、`Path`、`Environment`），而非直接依赖操作系统 API。下篇将深入探讨 **NuGet 包管理** 与 **依赖注入**，敬请期待。