第72章 .NET跨平台基础（Linux、macOS、Windows）
一、我踩过的跨平台坑：从“Linux下文件路径大小写导致服务崩溃”到“macOS沙箱拒绝访问文件”
把Windows上开发的文件上传服务迁到Linux后，启动就报“找不到配置文件”——查了半天发vb.net教程C#教程python教程SQL教程access 2010教程现代码里写的是Config/appsettings.json，但Linux上实际文件是config/appsettings.json（小写c），Linux文件系统区分大小写，直接找不到文件！还有一次在macOS上测试服务，读取用户文档目录时被拒绝，后来才知道macOS的沙箱机制默认禁止应用访问用户目录，需要在Info.plist里加权限申请。这节我把这些真实坑点揉进去，从文件系统、权限、进程管理三个核心维度拆解跨平台差异，结合代码逐行讲解，拓展底层原理和生产级技巧，让你一次踩完我踩过的所有坑！
二、Linux平台：从文件系统到进程管理，掌握.NET在Linux上的“生存法则”

1. 核心差异：文件系统区分大小写、权限严格
   我踩过的坑：文件路径大小写导致服务崩溃
   代码里写的是Config/appsettings.json，Linux上实际文件是config/appsettings.json，启动就报FileNotFoundException。后来在代码里统一用小写路径，或者用Path.Combine自动处理，问题解决！
   跨平台文件路径处理代码逐行讲解
   csharp

	using System;
	using System.IO;
	
	namespace CrossPlatformDemo;
	
	class FilePathDemo
	{
	static void Main(string[] args)
	{
	// 错误写法：硬编码路径，Linux下会因为大小写问题找不到文件
	// string configPath = "Config/appsettings.json";
	
	// 正确写法：用Path.Combine自动处理路径分隔符和大小写（推荐）
	string configPath = Path.Combine("config", "appsettings.json");
	Console.WriteLine($"配置文件路径：{configPath}");
	
	// 检查文件是否存在，跨平台兼容
	if (File.Exists(configPath))
	{
	string content = File.ReadAllText(configPath);
	Console.WriteLine("配置文件内容：");
	Console.WriteLine(content);
	}
	else
	{
	// 跨平台友好的错误提示
	Console.WriteLine($"错误：找不到配置文件 {configPath}");
	Console.WriteLine("注意：Linux文件系统区分大小写，请检查路径大小写是否正确！");
	}
	
	// 获取跨平台的特殊目录
	string homeDir = Environment.GetFolderPath(Environment.SpecialFolder.UserProfile);
	string tempDir = Path.GetTempPath();
	Console.WriteLine($"
用户主目录：{homeDir}");
	Console.WriteLine($"临时目录：{tempDir}");
	}
	}

代码逐行拆解（结合底层原理）

1. Path.Combine自动处理路径分隔符
   csharp
   string configPath = Path.Combine("config", "appsettings.json");
   底层作用：自动根据操作系统选择路径分隔符，Windows用，Linux/macOS用/；
   拓展知识：Linux文件系统区分大小写，Windows不区分，所以代码里尽量用小写路径，或者用StringComparison.OrdinalIgnoreCase比较路径。
2. Environment.GetFolderPath获取特殊目录
   csharp
   string homeDir = Environment.GetFolderPath(Environment.SpecialFolder.UserProfile);
   底层作用：跨平台获取用户主目录，Windows是C:Users用户名，Linux是/home/用户名，macOS是/Users/用户名；
   拓展知识：常用的特殊目录还有Environment.SpecialFolder.ApplicationData（应用数据目录）、Environment.SpecialFolder.LocalApplicationData（本地应用数据目录）。
3. Linux权限管理：避免“Permission denied”的核心技巧
   我踩过的坑：服务启动报“Permission denied”
   把.NET服务部署到Linux后，启动就报Permission denied，查了半天发现是服务文件没有执行权限。后来用chmod +x MyService给文件加执行权限，问题解决！
   核心权限命令逐行讲解
   bash

	# 查看文件权限
	ls -l MyService
	# 输出示例：-rw-r--r-- 1 root root 1000000 Mar 30 10:00 MyService
	# 权限位：rw-r--r--，表示所有者可读可写，组和其他用户只读
	
	# 给文件加执行权限
	chmod +x MyService
	# 权限位变成：rwxr-xr-x，所有者可读可写可执行，组和其他用户可读可执行
	
	# 运行服务
	./MyService

底层原理拓展
Linux权限位：用9位表示，前3位是所有者权限，中间3位是组权限，后3位是其他用户权限；
权限符号：r（读，4）、w（写，2）、x（执行，1），比如rwx是4+2+1=7，r--是4；
生产级技巧：部署服务时，尽量用普通用户运行，不要用root，减少安全风险：
bash

	# 创建普通用户
	useradd myservice
	# 切换到普通用户
	su myservice
	# 运行服务
	./MyService

3. Linux进程管理：用systemd托管.NET服务
   我踩过的坑：服务重启后自动退出
   直接用./MyService运行服务，服务器重启后服务就退出了。后来用systemd托管服务，设置开机自启，问题解决！
   systemd配置文件逐行讲解（/etc/systemd/system/myservice.service）
   ini

	[Unit]
	Description=My .NET Service # 服务描述
	After=network.target # 网络启动后再启动服务
	
	[Service]
	User=myservice # 用普通用户运行服务
	WorkingDirectory=/opt/myservice # 服务工作目录
	ExecStart=/usr/bin/dotnet /opt/myservice/MyService.dll # 启动命令
	Restart=always # 服务崩溃或重启后自动重启
	RestartSec=3 # 重启间隔3秒
	Environment=ASPNETCORE_ENVIRONMENT=Production # 设置环境变量
	
	[Install]
	WantedBy=multi-user.target # 多用户模式下开机自启

配置后操作命令
bash

	# 重新加载systemd配置
	sudo systemctl daemon-reload
	# 启动服务
	sudo systemctl start myservice
	# 设置开机自启
	sudo systemctl enable myservice
	# 查看服务状态
	sudo systemctl status myservice
	# 查看服务日志
	journalctl -u myservice -f # -f表示实时查看日志

底层原理拓展
systemd是Linux的系统和服务管理器：负责启动、停止、监控服务，设置开机自启；
Restart=always：服务崩溃、被杀死或服务器重启后，systemd会自动重启服务，保证服务高可用；
生产级技巧：用journalctl查看服务日志，比直接看控制台日志更方便，还能保存历史日志。
三、macOS平台：沙箱机制、Homebrew部署，掌握.NET在macOS上的“特殊规则”

1. 核心差异：沙箱机制、权限申请
   我踩过的坑：读取用户文档目录被拒绝
   在macOS上测试服务，读取/Users/用户名/Documents目录时被拒绝，后来在Info.plist里加了NSDocumentsFolderUsageDescription权限申请，问题解决！
   跨平台权限申请代码逐行讲解（macOS专属）
   Info.plist配置
   xml

	<key>NSDocumentsFolderUsageDescription</key>
	<string>需要访问文档目录读取用户上传的文件</string>

底层作用：macOS的沙箱机制默认禁止应用访问用户目录，需要在Info.plist里申请权限，并说明用途，用户同意后才能访问；
拓展知识：常用的权限还有NSDownloadsFolderUsageDescription（下载目录）、NSDesktopFolderUsageDescription（桌面目录）。
2. 用Homebrew部署.NET服务
核心命令逐行讲解
bash

	# 安装Homebrew（如果没安装）
	/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
	
	# 安装.NET SDK
	brew install dotnet-sdk
	
	# 部署.NET服务到/usr/local/bin
	sudo cp MyService /usr/local/bin
	# 给文件加执行权限
	sudo chmod +x /usr/local/bin/MyService
	
	# 启动服务
	MyService

底层原理拓展
Homebrew是macOS的包管理器：类似Linux的apt、yum，用来安装和管理软件；
/usr/local/bin是系统默认的可执行文件目录：把服务放到这里，直接用服务名启动，不用输完整路径。
四、Windows平台：注册表、服务托管，掌握.NET在Windows上的“传统优势”

1. 核心差异：注册表存储配置、服务用Windows Service托管
   我踩过的坑：注册表权限导致服务无法读取配置
   服务用Local System账户运行，读取注册表时被拒绝，后来把注册表权限改成Everyone可读，问题解决！
   跨平台注册表读取代码逐行讲解（Windows专属）
   csharp

	using System;
	using Microsoft.Win32;
	
	namespace CrossPlatformDemo;
	
	class RegistryDemo
	{
	static void Main(string[] args)
	{
	// 跨平台判断：只有Windows平台才访问注册表
	if (Environment.OSVersion.Platform == PlatformID.Win32NT)
	{
	try
	{
	// 打开注册表项
	using (RegistryKey key = Registry.LocalMachine.OpenSubKey(@"SOFTWAREMyService"))
	{
	if (key != null)
	{
	// 读取配置值
	string apiKey = key.GetValue("ApiKey") as string;
	Console.WriteLine($"API密钥：{apiKey}");
	}
	else
	{
	Console.WriteLine("错误：找不到注册表项");
	}
	}
	}
	catch (UnauthorizedAccessException ex)
	{
	Console.WriteLine($"权限错误：{ex.Message}");
	Console.WriteLine("解决方法：给注册表项添加Everyone可读权限");
	}
	}
	else
	{
	Console.WriteLine("当前平台不是Windows，无法访问注册表");
	}
	}
	}

代码逐行拆解（结合底层原理）

1. 跨平台判断
   csharp
   if (Environment.OSVersion.Platform == PlatformID.Win32NT)
   底层作用：判断当前平台是否是Windows，避免在Linux/macOS上运行时抛出异常；
   拓展知识：Linux对应的PlatformID是Unix，macOS也是Unix，可以用RuntimeInformation.IsOSPlatform(OSPlatform.Linux)更精确判断。
2. 注册表权限问题
   csharp
   catch (UnauthorizedAccessException ex)
   底层原理：Windows注册表权限严格，Local System账户默认没有读取某些注册表项的权限，需要手动添加权限；
   拓展知识：推荐用Environment.GetEnvironmentVariable读取环境变量，跨平台兼容，比注册表更灵活。
3. 用Windows Service托管.NET服务
   核心命令逐行讲解
   cmd

	# 安装.NET服务为Windows Service
	sc create MyService binPath= "C:MyServiceMyService.exe" start= auto displayname= "My .NET Service"
	
	# 启动服务
	sc start MyService
	
	# 停止服务
	sc stop MyService
	
	# 删除服务
	sc delete MyService

注意：binPath=和start=后面必须有空格，否则会报错；
拓展知识：用sc query MyService查看服务状态，用Event Viewer查看服务日志。
五、跨平台开发生产级技巧

1. 用RuntimeInformation精确判断平台
   csharp

	using System.Runtime.InteropServices;
	
	// 判断是否是Linux
	if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux))
	{
	Console.WriteLine("当前平台是Linux");
	}
	// 判断是否是macOS
	else if (RuntimeInformation.IsOSPlatform(OSPlatform.OSX))
	{
	Console.WriteLine("当前平台是macOS");
	}
	// 判断是否是Windows
	else if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
	{
	Console.WriteLine("当前平台是Windows");
	}

2. 用Docker跨平台部署（推荐）
   Dockerfile逐行讲解
   dockerfile

	# 用官方.NET SDK镜像构建
	FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
	WORKDIR /src
	COPY ["MyService.csproj", "."]
	RUN dotnet restore "MyService.csproj"
	COPY . .
	RUN dotnet build "MyService.csproj" -c Release -o /app/build
	
	# 用官方.NET Runtime镜像运行，体积小
	FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS runtime
	WORKDIR /app
	COPY --from=build /app/build .
	ENTRYPOINT ["dotnet", "MyService.dll"]

底层原理：Docker是跨平台的容器引擎，把服务和依赖打包成镜像，在任何支持Docker的平台上运行；
生产级技巧：用多阶段构建，SDK镜像用来构建，Runtime镜像用来运行，镜像体积从1GB缩小到200MB左右。
3. 用CI/CD自动测试多平台
GitHub Actions配置示例（.github/workflows/cross-platform.yml）
yaml

	name: 跨平台测试
	on: [push, pull_request]
	
	jobs:
	build:
	runs-on: ${{ matrix.os }}
	strategy:
	matrix:
	os: [ubuntu-latest, windows-latest, macos-latest] # 测试三个平台
	dotnet-version: ['8.0.x']
	
	steps:
	- uses: actions/checkout@v4
	- name: 设置.NET版本
	uses: actions/setup-dotnet@v4
	with:
	dotnet-version: ${{ matrix.dotnet-version }}
	- name: 还原依赖
	run: dotnet restore
	- name: 构建项目
	run: dotnet build --configuration Release --no-restore
	- name: 运行测试
	run: dotnet test --no-restore --verbosity normal

底层作用：每次代码提交，自动在Linux、Windows、macOS三个平台上构建和测试，提前发现跨平台问题；
拓展知识：可以添加部署步骤，自动把服务部署到三个平台的服务器上。
六、总结与选型建议

1. 跨平台差异对比表

2. 跨平台开发流程
   1.用跨平台API：尽量用Path、Environment、RuntimeInformation等跨平台API，避免硬编码平台专属代码；
   2.多平台测试：在Linux、Windows、macOS三个平台上测试，提前发现差异；
   3.用Docker部署：把服务打包成Docker镜像，跨平台运行，减少环境差异；
   4.用CI/CD自动测试：每次代码提交自动在三个平台上测试，保证跨平台兼容性。
   现在你已经掌握了.NET跨平台开发的核心技巧，从文件路径处理到服务托管，再到Docker部署，以后跨平台开发不用慌，按照这个流程来，90%的问题都能提前避免！下一节我们会学习“跨平台性能优化”，结合三个平台的差异，教你优化.NET服务的性能！

转载请注明出处：https://www.xin3721.com/ArticlecSharp/c49592.html