09.5 阶段 4:工具链、工程化与测试
所属:全栈开发面试题库 / 学习路径 / 09 C# 与 .NET 全栈
本页目录
一、阶段定位
前四个阶段解决"写得出、跑得对、不卡"。本阶段把个人代码升级为"团队可复现、可测试、可交付"的工程。重点是三件事:
- 依赖可复现:NuGet 版本约束、
Directory.Packages.props统一管理、global.json锁 SDK,让团队成员与 CI 在同一环境构建。 - 构建可解释:读懂 csproj 的属性、项、Target,多目标框架与条件编译,知道一个库为什么能面向多个框架。
- 测试可独立: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 分钟内给出排查路径
自测题(先自己想,再看要点):
Directory.Packages.props解决什么问题?- 要点:集中管理包版本,多项目版本一致,升级一处生效,避免传递依赖冲突。
global.json锁的是什么?- 要点:SDK 版本,让团队与 CI 用同一 SDK 构建,结果可复现。
- Fact 与 Theory 的区别?
- 要点:Fact 单组用例;Theory 配合 InlineData 参数化,一次写方法跑多组输入。
- 测试为什么要抽象接口而不是直接 new 实现?
- 要点:抽象接口才能在测试里替换成假实现,让测试独立于外部依赖,快而可重复。
- 覆盖率 90% 是否就够了?
- 要点:不够。覆盖率只看"走到了",不看断言是否充分、边界是否覆盖。
- 多目标框架下调用了老框架没有的 API,怎么处理?
- 要点:用
#if 框架符号条件编译,新框架用新 API,老框架给替代实现。
- 要点:用
- 源生成器相比反射在 AOT 下的优势?
- 要点:编译期生成代码,不依赖运行时反射,裁剪后仍可用,AOT 友好。