罗罗编程学习记录
本页内容 展开查看

09.5 阶段 4:工具链、工程化与测试

所属:全栈开发面试题库 / 学习路径 / 09 C# 与 .NET 全栈

本页目录

一、阶段定位

前四个阶段解决"写得出、跑得对、不卡"。本阶段把个人代码升级为"团队可复现、可测试、可交付"的工程。重点是三件事:

  1. 依赖可复现:NuGet 版本约束、Directory.Packages.props 统一管理、global.json 锁 SDK,让团队成员与 CI 在同一环境构建。
  2. 构建可解释:读懂 csproj 的属性、项、Target,多目标框架与条件编译,知道一个库为什么能面向多个框架。
  3. 测试可独立:xUnit 的 Fact/Theory/Fixture、对外部依赖做 Mock、覆盖率——测试不依赖数据库与文件系统,一条命令跑完。

本阶段与前后阶段的衔接:往上承接阶段 3,本阶段的测试要能验证你写的并发与 GC 逻辑;往下接 阶段 5 ASP.NET Core 框架主线,那时的 API 项目就靠本阶段的工程骨架与测试方法支撑。跳过工程化直接进框架,后面"我这能跑、CI 上跑不通""测试连真数据库"会反复出现。

原有卡点的可判断现象依据:

  • 依赖版本过宽导致还原冲突:判断标准是——csproj 里写 PackageReference Version="*" 或 >=6.0.0,团队成员还原出不同版本,CI 上偶发失败。
  • 测试直接依赖数据库或文件系统:判断标准是——单测一跑就去连真实库、读真实文件,换台机器或 CI 上失败,无法独立运行。
  • Mock 做成对实现细节的复述:判断标准是——Mock 对象的返回值是照着真实方法的实现抄的,测试变成"复述代码",代码一改测试就崩,失去保护作用。
  • 多目标框架下误用仅单一框架可用的 API:判断标准是——库面向 net8.0 与 netstandard2.0,调用了后者不存在的 API,编译在某框架失败。

二、阶段目标与投入

学完本页,应当能用可观察的行为证明以下六条能力:

能力目标(可验证的行为) 验证方式
能用 Directory.Packages.props 统一管理包版本 多个项目引用同一包时版本由一处控制
能用 global.json 锁定 SDK 版本 dotnet --version 显示锁定版本
能读懂 csproj 的属性与项 指出一个属性控制了什么
能写 xUnit 的 Fact 与 Theory 参数化用例 dotnet test 跑出多条用例
能对外部协作对象做 Mock 隔离 测试不依赖数据库/文件系统
能跑测试覆盖率并解读 覆盖率报告显示核心路径被覆盖

建议学时:

  • 全职(每天有效学习 4–6 小时):2 周,约 55 小时。
  • 在职(每天 2 小时、周末补 4 小时):5 周。

学时分配建议:NuGet 与版本管理 20%、MSBuild 与 csproj 15%、多目标框架与源生成器 10%、xUnit 与 Fixture 25%、Mock 与隔离 20%、覆盖率 10%。测试方法是团队协作的硬门槛,时间要给够。

三、先修自检

进入本阶段前逐条自检;任何一条做不到,先回到对应页面补齐。

先修项 合格标准 不合格时回到
dotnet CLI 会 new/restore/build/test 09.1 阶段 0
解决方案结构 能建多项目并引用 09.1 阶段 0
类与接口 能写接口与实现,理解依赖抽象 09.2 阶段 1
异步与并发 能写 async、理解取消 09.4 阶段 3

四、知识地图

"掌握程度"分三档:了解、会用、能讲清原理。

模块 知识点 掌握程度 对应题库章节
NuGet 与版本 版本约束、传递依赖、Directory.Packages.props、私有源 会用 06.1 通用后端工程
SDK 与 MSBuild global.json、csproj 属性/项/Target、-c Release 会用 06.1 通用后端工程
多目标框架 TargetFrameworks、条件编译、平台 API 防护 会用 06.1 通用后端工程
源生成器 编译期生成代码、与反射的取舍 了解 06.1 通用后端工程
xUnit Fact/Theory/Fixture、共享上下文、断言 会用 06.1 通用后端工程
Mock 与覆盖率 接口隔离、Moq/NSubstitute、覆盖率边界 会用 06.1 通用后端工程

进度管理建议:把这张表复制到笔记里,三档都到位再进 阶段 5。《知识点全清单》是更细的全量清单。

五、分模块精讲

5.1 NuGet 包管理与版本统一

为什么需要它:多个项目引用同一个包,版本各写各的,迟早冲突。Directory.Packages.props 把版本集中到一处,是现代 .NET 的标准做法。

核心机制:

  • Directory.Packages.props 放在解决方案根目录,统一声明所有包版本;csproj 里 <PackageReference> 只写包名不写版本。
  • ManagePackageVersionsCentrally 开启集中管理。
  • 版本约束:精确 6.0.0、浮动 6.0.*、区间 [6.0.0,7.0.0);生产用精确版保证可复现。
  • 私有源:在 nuget.config 配置公司源,还原时先查私有源。

最小可运行示例:

<!-- Directory.Packages.props(解决方案根目录) -->
<Project>
  <PropertyGroup>
    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
  </PropertyGroup>
  <ItemGroup>
    <PackageVersion Include="Newtonsoft.Json" Version="13.0.3" />
    <PackageVersion Include="xunit" Version="2.6.6" />
  </ItemGroup>
</Project>
<!-- 各个 csproj 只写包名,不写版本 -->
<ItemGroup>
  <PackageReference Include="Newtonsoft.Json" />
</ItemGroup>
# 还原指定配置
dotnet restore
# 发布 Release 配置
dotnet build -c Release
dotnet publish -c Release

常见坑:

现象 原因 修法
团队成员还原出不同版本 用了浮动版本约束 改为精确版,用集中管理
csproj 写了版本却报错 开启集中管理后不允许写版本 版本移到 Directory.Packages.props
私有包还原 403 私有源未配置 在 nuget.config 加源与凭据

面试考法:常见问法是"集中管理包版本解决什么问题"。要答出:版本统一、避免冲突、升级一处生效;生产用精确版保证可复现。

5.2 global.json 锁定 SDK 与 csproj 基础

为什么需要它:不锁 SDK,团队成员本机版本不同,构建结果就有差异。读懂 csproj 是改构建行为的前提。

核心机制:

  • global.json 放在根目录,sdk.version 锁定本次构建用的 SDK 版本。
  • csproj 的结构:<PropertyGroup> 是属性(布尔/字符串开关),<ItemGroup> 是项(包、引用、文件),<Target> 是构建步骤。
  • 常用属性:TargetFramework(目标框架)、Nullable(可空引用类型)、LangVersion(语言版本)、IsPackable(是否可打包)。
  • -c Release 指定配置:Debug 带调试符号、Release 优化。

最小可运行示例:

{
  "sdk": { "version": "10.0.100", "rollForward": "latestMajor" }
}
<!-- 一个典型的 SDK 风格 csproj -->
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <Nullable>enable</Nullable>
    <LangVersion>latest</LangVersion>
  </PropertyGroup>
</Project>

常见坑:

现象 原因 修法
不同机器构建结果不一致 没锁 SDK 加 global.json
可空引用类型告警太多 项目级开启了但老代码没适配 逐模块开启,不要全局 disable
Release 调试符号缺失 用了 Debug 发布 dotnet publish -c Release

面试考法:常见问法是"csproj 里 PropertyGroup 和 ItemGroup 的区别"。要答出:属性是开关,项是包/引用/文件列表;Target 是构建步骤。

5.3 多目标框架与条件编译

为什么需要它:类库要同时给老系统(netstandard2.0)和新系统(net10.0)用,就要多目标编译。不掌握条件编译,就会在某框架上调用了不存在的 API 而失败。

核心机制:

  • TargetFrameworks 写多个目标框架,分号分隔,如 net10.0;netstandard2.0。
  • 每个框架有独立的编译符号:NET10_0、NETSTANDARD2_0。
  • #if NET10_0 条件编译:只在某框架下编译某段代码。
  • #nullable enable 等上下文也可按框架调整。

最小可运行示例:

<PropertyGroup>
  <TargetFrameworks>net10.0;netstandard2.0</TargetFrameworks>
</PropertyGroup>
#if NET10_0
    // 只有 net10.0 能编译:使用新 API
    var time = DateOnly.FromDateTime(DateTime.Now);
#else
    // 老框架的替代实现
    var time = DateTime.Now;
#endif

常见坑:

现象 原因 修法
某框架编译失败说 API 不存在 用了仅新框架有的 API 用 #if 包裹,老框架给替代实现
两个目标框架产物搞混 输出目录按框架分 每个框架有独立输出目录,不要手工改

面试考法:常见问法是"为什么要多目标""netstandard 是什么"。要答出:一份库代码面向多个运行时,覆盖老系统与新系统;netstandard 是 .NET Framework 与 .NET Core/.NET 5+ 的共享 API 标准。

5.4 源生成器概念

为什么需要它:反射在 NativeAOT 下会被裁剪,动态生成的代码会失效。源生成器在编译期生成代码,是 AOT 友好的替代方案。

核心机制:

  • 源生成器在编译期分析代码,生成额外的 C# 源码一起编译,不依赖运行时反射。
  • 典型场景:System.Text.Json 的源生成器模式、日志源生成器(LoggerMessage)。
  • 优势:AOT 友好、裁剪安全、编译期就能发现问题。
  • 与反射的取舍:反射灵活但 AOT 受限;源生成器稳定但需要编译期可见。

最小可运行示例:

// 用日志源生成器,避免运行时反射
public static partial class LogMessages
{
    [LoggerMessage(EventId = 1, Level = LogLevel.Information, Message = "订单 {OrderId} 已创建")]
    public static partial void OrderCreated(ILogger logger, string orderId);
}

常见坑:

现象 原因 修法
AOT 发布后序列化失败 用了反射式序列化 改用源生成器模式
源生成代码看不到 生成在 obj/ 目录 查看 obj 下生成的 .g.cs

面试考法:常见问法是"源生成器和反射的区别"。要答出:源生成器编译期生成代码,AOT 友好;反射运行时读取元数据,灵活但在裁剪/AOT 下失效。

5.5 xUnit:Fact、Theory 与 Fixture

为什么需要它:测试是工程化的核心。不会写参数化用例与共享上下文,就会写一堆重复的测试方法。

核心机制:

  • [Fact]:无参数的测试方法。
  • [Theory]:参数化测试,配合 [InlineData] 多组输入,一次写方法跑多组用例。
  • Fixture:测试间共享的上下文(如数据库连接、HttpClient),通过构造函数注入或 IClassFixture<T> 共享。
  • xUnit 默认为每个测试方法新建一个测试类实例(隔离),共享数据要靠 Fixture。

最小可运行示例:

public class CalculatorTests
{
    [Fact]
    public void Add_TwoNumbers_ReturnsSum()
    {
        var result = Calculator.Add(2, 3);
        Assert.Equal(5, result);
    }

    [Theory]
    [InlineData(1, 2, 3)]
    [InlineData(-1, 1, 0)]
    [InlineData(0, 0, 0)]
    public void Add_VariousInputs_ReturnsExpected(int a, int b, int expected)
    {
        Assert.Equal(expected, Calculator.Add(a, b));
    }
}
# 一条命令跑完所有测试
dotnet test

常见坑:

现象 原因 修法
测试间互相影响 在类里存了共享状态 每个测试方法用新实例,共享数据用 Fixture
用例重复难维护 写了一堆几乎一样的 Fact 改成 [Theory] 参数化
测试连真数据库 直接 new 了真实上下文 抽象接口,测试用内存假实现

面试考法:常见问法是"Fact 和 Theory 的区别""Fixture 解决什么问题"。要答出:Fact 单组用例,Theory 参数化多组;Fixture 共享昂贵的上下文(连接、HttpClient),避免每个测试重建。

5.6 Mock 与测试隔离

为什么需要它:测试一个服务,不想真的连数据库、调外部接口。Mock 把协作对象替换成可控的假对象,让测试独立、快速、可重复。

核心机制:

  • 依赖注入接口,测试时传入 Mock 实现,返回预设数据。
  • Mock 库(如 Moq、NSubstitute):能设置方法返回值、验证调用次数。
  • 隔离边界:只 Mock"你不拥有的东西"(外部依赖),不要 Mock 被测对象自己。
  • 覆盖率:衡量哪些代码被测试走过,高覆盖率不等于高质量——它不保证断言充分。

最小可运行示例:

public class OrderService
{
    private readonly IOrderRepository _repo;
    public OrderService(IOrderRepository repo) => _repo = repo;

    public int GetTotal() => _repo.FindAll().Sum(o => o.Amount);
}

// 测试:Mock 仓库,不连真库
var mockRepo = new Mock<IOrderRepository>();
mockRepo.Setup(r => r.FindAll()).Returns(new List<Order>
{
    new() { Amount = 100 },
    new() { Amount = 200 }
});

var service = new OrderService(mockRepo.Object);
Assert.Equal(300, service.GetTotal());

常见坑:

现象 原因 修法
Mock 跟着实现改,测试变脆 Mock 复述了实现细节 只 Mock 行为契约,不要 Mock 内部调用
覆盖率 90% 但线上还出 bug 覆盖率只看走到,不看断言 关注核心路径与边界条件
测试一跑就连真库 没抽象接口 抽象 IOrderRepository,注入假实现

面试考法:高频题是"什么时候该 Mock""覆盖率高就够了吗"。要答出:Mock 外部依赖(数据库、HTTP),不 Mock 被测对象;覆盖率只是"走到了",不代表断言正确、边界覆盖。

六、分层练习

三档练习逐档升级,上一档没做完不要跳。

6.1 复现型(照着做,目标是跑通 + 能解释)

练习 要求 验收标准 预计耗时
集中管理包版本 加 Directory.Packages.props 多项目引用同一包版本一致 1 小时
锁 SDK 版本 加 global.json dotnet --version 显示锁定版本 0.5 小时
写 Fact 与 Theory 一个加法方法两组用例 dotnet test 跑出多条 1 小时
Mock 一个仓库 抽象接口,Mock 返回固定数据 测试不连真库 1.5 小时

6.2 改造型(给出现成代码,改出正确行为)

练习 要求 验收标准 预计耗时
把浮动版本改精确 给定 * 版本,改为精确版 还原结果可复现 1 小时
把重复 Fact 改成 Theory 给定 3 个相似用例 合并成参数化 1 小时
测试连真库改内存假实现 给定直接 new 上下文 测试独立运行 2 小时
多目标框架加条件编译 老框架 API 不存在 用 #if 隔离,两框架都编译通过 1.5 小时

6.3 设计型(自己定方案,目标是能交付、能讲清取舍)

练习 要求 验收标准 预计耗时
标准解决方案工程 src/ + tests/ + 集中包管理 + 锁 SDK 新人 clone 一条命令跑通 build/test 3 小时
核心服务单元测试 为业务服务写测试,外部依赖全 Mock 测试快、独立、可重复 4 小时
测试覆盖率报告 跑覆盖率并解读哪些路径没覆盖 能指出核心路径覆盖缺口 2 小时

七、排障表

现象 可能原因 排查步骤 解决办法
团队成员还原出不同版本 浮动版本约束 看 csproj 版本写法 用精确版 + 集中管理
csproj 写了版本报错 开启集中管理 检查是否 ManagePackageVersionsCentrally 版本移到 props
不同机器构建不一致 没锁 SDK 对比 dotnet --version 加 global.json
多目标框架某框架编译失败 用了该框架没有的 API 看报错的 API 用 #if 隔离
测试连真库/文件系统 没抽象接口 看测试是否 new 了真实依赖 抽象接口,注入假实现
测试间互相影响 共享状态在类字段 看是否每个用例用新实例 用 Fixture 管理共享上下文
Mock 一改实现测试就崩 Mock 复述实现细节 看 Mock 是否在验证内部调用 只 Mock 行为契约
AOT 发布后反射失效 用了反射式序列化 看是否 NativeAOT 改源生成器模式

八、出口条件

全部勾选后再进入 阶段 5 ASP.NET Core 框架主线。

  • [ ] 能用 Directory.Packages.props 统一管理包版本,用 global.json 锁 SDK
  • [ ] 能读懂 csproj 的 PropertyGroup 与 ItemGroup,知道 -c Release 的作用
  • [ ] 能写多目标框架并用条件编译隔离 API
  • [ ] 能写 xUnit 的 Fact 与 Theory,用 Fixture 共享上下文
  • [ ] 能对外部依赖做 Mock,让测试独立于数据库/文件系统
  • [ ] 能跑覆盖率并解读它的边界
  • [ ] 排障表里的八个现象,随机抽三个能在 5 分钟内给出排查路径

自测题(先自己想,再看要点):

  1. Directory.Packages.props 解决什么问题?
    • 要点:集中管理包版本,多项目版本一致,升级一处生效,避免传递依赖冲突。
  2. global.json 锁的是什么?
    • 要点:SDK 版本,让团队与 CI 用同一 SDK 构建,结果可复现。
  3. Fact 与 Theory 的区别?
    • 要点:Fact 单组用例;Theory 配合 InlineData 参数化,一次写方法跑多组输入。
  4. 测试为什么要抽象接口而不是直接 new 实现?
    • 要点:抽象接口才能在测试里替换成假实现,让测试独立于外部依赖,快而可重复。
  5. 覆盖率 90% 是否就够了?
    • 要点:不够。覆盖率只看"走到了",不看断言是否充分、边界是否覆盖。
  6. 多目标框架下调用了老框架没有的 API,怎么处理?
    • 要点:用 #if 框架符号 条件编译,新框架用新 API,老框架给替代实现。
  7. 源生成器相比反射在 AOT 下的优势?
    • 要点:编译期生成代码,不依赖运行时反射,裁剪后仍可用,AOT 友好。