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

04.6.4.2 项目结构与多目标框架

所属:全栈开发面试题库 / 04 后端语言与运行时 / 04.6 C# 与 .NET / 04.6.4 NuGet 与工程实践

04.6.4.2-001 一个 .NET 解决方案通常怎么组织?

一句话结论

常见布局:src/ 放业务项目,tests/ 放测试项目,根目录解决方案文件与共享 props;按分层划分 Api、Application、Domain、Infrastructure 等项目。

概念解释

目录结构让代码职责清晰、依赖方向明确。src 内按层/模块拆分项目,tests 与对应源码项目平级组织;公共构建配置集中在 props 文件。

原理流程

  1. 根目录建 sln 与配置文件。
  2. src 下分层/分模块建项目。
  3. tests 下建对应测试项目并引用源码项目。

代码或图示

Ann-Interview.sln
src/
  Api/  Application/  Domain/  Infrastructure/
tests/
  Api.Tests/  Application.Tests/

常见误区

  • 所有代码塞一个项目:职责混杂,编译与测试边界不清。
  • 测试项目与源码目录混放:发布打包与依赖解析混乱。

追问

  • 按模块还是分层拆分?答:小项目分层即可;大团队按业务模块边界拆项目,模块内再分层。
  • 共享配置放哪?答:Directory.Build.props 与 Directory.Packages.props 集中,避免各项目重复。

04.6.4.2-002 SDK 风格项目文件结构?

一句话结论

SDK 风格 csproj 以 <Project Sdk="..."> 声明,默认隐式包含目录下源码与引用,显式声明包引用、目标框架与构建属性。

概念解释

新式项目文件精简:SDK 默认 glob 包含源码与资源,无需显式列出每个 .cs。显式配置 TFM、包引用、输出与编译选项。

原理流程

  1. 声明 SDK(Web/类库/Worker 等)。
  2. 属性区配置框架、版本、输出。
  3. ItemGroup 声明包与项目引用。

代码或图示

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
  </PropertyGroup>
</Project>

常见误区

  • 旧式 packages.config 与新式混用:新项目统一 PackageReference 风格。
  • 显式排除默认包含规则:理解 SDK 默认 glob 后再调整排除项。

追问

  • SDK 有哪些类型?答:类库、Web、Worker、控制台等 SDK;Web 项目引用 Web SDK。
  • 项目文件在哪里编辑?答:csproj XML,可在 IDE 属性界面或文本编辑器修改。

04.6.4.2-003 Directory.Build.props 共享什么配置?

一句话结论

仓库级 Directory.Build.props 在各项目编译前自动导入,集中放公共属性:语言版本、常量、输出约定、版本号、分析规则等。

概念解释

props 避免每个项目重复写相同配置。目录层级 props 逐级合并,根目录定义全局项,子目录可局部覆盖。包版本集中在 Directory.Packages.props。

原理流程

  1. 根目录建 props 定义公共 PropertyGroup。
  2. 各项目编译前自动导入。
  3. 局部项目需要差异化时在本项目覆盖。

代码或图示

<PropertyGroup>
  <LangVersion>latest</LangVersion>
  <Nullable>enable</Nullable>
</PropertyGroup>

常见误区

  • 公共配置复制到每个 csproj:升级时逐项目改,易遗漏。
  • 根 props 写项目专属项:应下沉到具体项目,保持 props 通用。

追问

  • props 与 targets 区别?答:props 在编译前导入定义属性/项;targets 在构建任务阶段执行目标逻辑。
  • 多级 props 覆盖顺序?答:外层先导入,内层项目属性可覆盖;具体合并规则以 MSBuild 为准。

04.6.4.2-004 global.json 固定 SDK 版本?

一句话结论

global.json 锁定构建使用的 .NET SDK 版本,保证团队与 CI 使用同一工具链;版本不匹配时还原/构建按声明选择 SDK。

概念解释

SDK 版本影响编译行为与还原规则。固定 global.json 避免「本机能构建、CI 失败」的工具链差异;CI 环境安装对应 SDK。

原理流程

  1. 仓库根声明 SDK 版本/渠道。
  2. 命令行解析按 global.json 选择 SDK。
  3. 团队/CI 统一工具链版本。

代码或图示

{
  "sdk": { "version": "8.0.100", "rollForward": "latestFeature" }
}

常见误区

  • 提交不同 SDK 行为的项目:构建结果随机器 SDK 变化。
  • rollForward 配置过宽:绕过版本锁定,失去一致性意义。

追问

  • SDK 与运行时版本区别?答:SDK 含编译工具链,运行时执行应用;global.json 控制 SDK,发布产物带运行时策略另配。
  • 多 SDK 并存?答:机器可装多版本,global.json 指定使用哪个。

04.6.4.2-005 项目引用与包引用怎么选?

一句话结论

同解决方案内共享代码用项目引用(ProjectReference),外部/第三方复用代码用包引用(PackageReference);项目引用随源码一起编译,包引用取已发布产物。

概念解释

项目引用传递项目依赖与编译上下文,便于联调;包引用解耦版本,适合跨团队/外部依赖。内部多项目迭代优先项目引用,稳定共享库可打包发布。

原理流程

  1. 同仓代码改动:ProjectReference 直接编译源码。
  2. 外部/第三方:PackageReference 拉取包产物。
  3. 依赖沿引用链解析传递资产。

代码或图示

<ProjectReference Include="..\Domain\Domain.csproj" />
<PackageReference Include="Serilog" Version="3.1.1" />

常见误区

  • 跨团队内部代码用项目引用:源码边界耦合,应打包为私有包。
  • 同仓改动用包引用:需反复打包发布,迭代效率低。

追问

  • 项目引用传递哪些资产?答:被引用项目的输出与传递依赖;私有资产默认不对外传递。
  • 项目引用能替代包版本管理吗?答:不能,跨仓/跨版本发布仍需包机制。

04.6.4.2-006 多目标框架怎么配置?

一句话结论

TargetFrameworks 分号列出多个 TFM,项目为每个框架分别编译;条件代码按 #if TFM 或 MSBuild 条件适配,输出各框架程序集。

概念解释

多目标让同一代码库支持多个 .NET 版本/平台。公共代码共享,框架差异部分用条件编译或条件引用分离。每个 TFM 独立还原包资产。

原理流程

  1. 声明多个 TargetFramework。
  2. 编译为每个框架生成程序集。
  3. 条件分支按目标框架选择代码/引用。

代码或图示

<TargetFrameworks>net8.0;netstandard2.0</TargetFrameworks>

常见误区

  • 多目标只测一个框架:各 TFM 包兼容与条件分支需分别构建验证。
  • 公共代码依赖新框架 API:低目标框架编译失败,需条件隔离。

追问

  • netstandard 用途?答:作为兼容标准被多框架引用;类库跨目标复用时选择。
  • 多目标输出在哪?答:各框架对应输出子目录,发布按目标选取。

04.6.4.2-007 项目引用循环依赖怎么避免?

一句话结论

循环引用(A 引 B、B 引 A)导致编译失败;通过调整分层方向、下沉共享模型、抽取公共项目打破环。

概念解释

依赖应单向流动:高层依赖低层,低层不反向依赖高层。出现环说明职责划分不清,需把共享代码/接口下沉到公共项目。

原理流程

  1. 梳理项目间引用边。
  2. 检测成环路径。
  3. 下沉共享类型/接口,调整引用方向。

代码或图示

Api → Application → Domain
Infrastructure → Application(实现接口)
Domain 不依赖上层

常见误区

  • 为图方便双向引用:编译解析成环,项目无法构建。
  • 把通用模型放进上层:低层被迫反向依赖。

追问

  • 循环依赖编译报什么?答:项目引用环检测错误,提示循环依赖链。
  • 接口倒置打破环?答:高层定义接口,低层/基础设施实现,依赖方向指向高层抽象。

04.6.4.2-008 程序集信息与版本号?

一句话结论

程序集版本含主/次/构建/修订与信息版本;版本属性在项目文件或 AssemblyInfo 声明,NuGet 包版本与程序集版本可分别管理。

概念解释

程序集版本用于运行时绑定与强名称;包版本用于 NuGet 解析。发布版本记录变更与兼容级别,程序集信息版本补充说明。

原理流程

  1. 声明版本属性。
  2. 编译写入程序集元数据。
  3. 运行时绑定与包解析分别读取。

代码或图示

<Version>1.2.3</Version>
<AssemblyVersion>1.0.0.0</AssemblyVersion>

常见误区

  • 混淆包版本与程序集版本:两者用途不同,可独立设置。
  • 版本号不随发布更新:兼容性追踪困难。

追问

  • 强名称签名作用?答:标识程序集身份与完整性;现代 .NET 对强名称依赖减弱,具体场景以文档为准。
  • 版本号怎么定?答:遵循语义化版本,补丁/小版本/主版本对应变更级别。

04.6.4.2-009 常用构建属性有哪些?

一句话结论

常用属性:TargetFramework、OutputType、AssemblyName、RootNamespace、Nullable、LangVersion、Deterministic、输出路径与平台目标。

概念解释

构建属性控制编译输出、语言行为与程序集元数据。公共属性上收 props,项目内只放差异化配置。理解属性有助于排查编译与输出问题。

原理流程

  1. SDK 默认提供基础属性。
  2. props/项目覆盖公共配置。
  3. 编译按属性生成程序集与输出。

代码或图示

<PropertyGroup>
  <OutputType>Exe</OutputType>
  <AssemblyName>MyApp</AssemblyName>
  <Deterministic>true</Deterministic>
</PropertyGroup>

常见误区

  • 复制粘贴默认配置:依赖 SDK 默认值即可,只覆盖需要调整的项。
  • 输出路径在项目内硬编码:按构建约定输出到统一目录结构。

追问

  • Deterministic 是什么?答:相同输入生成相同输出程序集,利于可复现构建与缓存校验。
  • 平台目标属性?答:PlatformTarget/运行时 RID 控制 CPU 架构适配。

04.6.4.2-010 解决方案文件与项目组织?

一句话结论

.sln 列出解决方案内项目与构建配置,IDE 与命令行据此加载解决方案;项目在 sln 中按解决方案文件夹分组,不影响磁盘目录。

概念解释

sln 是项目集合与配置映射,源码物理目录由文件系统决定。大型解决方案可用解决方案文件夹逻辑分组,便于浏览。

原理流程

  1. sln 登记各项目路径与配置。
  2. 构建/还原按 sln 解析全部项目。
  3. 分组只影响 IDE 浏览视图。

代码或图示

Ann-Interview.sln
  src/ (解决方案分组)
  tests/(解决方案分组)

常见误区

  • 以为 sln 文件夹等于磁盘目录:分组是逻辑视图,物理路径在 csproj 中。
  • 新增项目不登记 sln:IDE 解决方案看不到,命令行单独构建可用但整体构建遗漏。

追问

  • 解决方案与单项目构建?答:dotnet build 可针对 sln 或单个 csproj;sln 管理整体依赖顺序。
  • sln 文件需要手写吗?答:通常由 IDE/CLI 生成,手工修改需保持格式合法。

04.6.4.2-011 分层架构的依赖方向?

一句话结论

典型分层:Api(接入层)→ Application(业务用例)→ Domain(领域模型);Infrastructure 实现 Application/Domain 定义的接口,依赖方向不反向流向 Domain。

概念解释

依赖规则保证内层模型稳定,外层随需求变化。Domain 不依赖框架与基础设施;接口定义在消费方,实现由基础设施提供(依赖倒置)。

原理流程

  1. Domain 放核心模型与规则。
  2. Application 编排用例与端口接口。
  3. Infrastructure 实现端口,Api 组装启动。

代码或图示

Api → Application → Domain
Infrastructure → Application/Domain(实现接口)

常见误区

  • Domain 直接引用数据库/框架:核心被外部技术绑定,难测试与复用。
  • Infrastructure 反向定义接口给 Application 实现:依赖方向倒置。

追问

  • 分层与项目拆分关系?答:一层可对应一个或多个项目;小应用可合并层但保持依赖方向。
  • 跨层共享什么?答:共享模型与接口下沉 Domain/公共层,不放实现细节。

04.6.4.2-012 条件编译符号与 #if?

一句话结论

#if/#elif/#else/#endif 按预处理器符号编译不同代码段;符号可在项目属性定义,用于调试/平台/功能差异代码隔离。

概念解释

条件编译在编译期排除代码,不生成到程序集。与运行时判断不同:条件段不参与编译,适合框架差异与调试辅助代码。

原理流程

  1. 定义/传入编译符号。
  2. 预处理器按符号保留/排除代码段。
  3. 编译产物只含启用段。

代码或图示

#if DEBUG
Log.Debug("debug info");
#endif

常见误区

  • 用条件编译替代运行时配置:功能开关应按场景选择编译期或运行时方案。
  • 条件段内留残缺代码:未启用段编译不检查,启用后易出错。

追问

  • 符号在哪定义?答:项目属性 DefineConstants 或命令行参数;Debug/Release 配置默认带符号。
  • 条件编译与多目标关系?答:可结合 TFM 条件,按框架隔离 API 调用。

04.6.4.2-013 InternalsVisibleTo 与内部可见性?

一句话结论

internal 成员只在同程序集可见;InternalsVisibleTo 授权指定测试/友元程序集访问内部成员,用于测试内部实现而不暴露为公共 API。

概念解释

友元程序集在编译期授权可见性,测试项目可访问 internal 类型与方法。保持公共 API 精简,内部细节不对外暴露。

原理流程

  1. 源码成员声明 internal。
  2. 程序集标注 InternalsVisibleTo 友元名。
  3. 友元项目编译可访问 internal。

代码或图示

[assembly: InternalsVisibleTo("App.Tests")]

常见误区

  • 为测试把成员改 public:扩大公共 API 表面,破坏封装。
  • 友元名写错:测试项目编译看不到 internal 成员。

追问

  • 友元与强名称?答:签名程序集的友元授权需包含公钥信息,具体规则以文档为准。
  • 内部成员测试边界?答:优先测公共行为;内部实现确需直接测试时用友元授权。

04.6.4.2-014 多目标下的条件包引用?

一句话结论

不同 TFM 可引用不同包版本/包集合,用 Condition 按目标框架限定 PackageReference,避免低框架拉入不兼容资产。

概念解释

高层框架专用 API 对应专属包,低框架需替代实现。条件引用让每个目标框架拿到适配依赖,编译分别校验。

原理流程

  1. 按 TFM 写条件包引用。
  2. 各目标框架还原对应资产。
  3. 代码内条件编译隔离框架调用。

代码或图示

<PackageReference Include="Newtonsoft.Json" Condition="'$(TargetFramework)' == 'netstandard2.0'" />

常见误区

  • 条件漏写导致某框架缺包:多目标构建逐框架检查还原结果。
  • 同一包不同版本混用:传递依赖冲突时统一版本策略。

追问

  • 条件引用能按配置吗?答:可基于任意 MSBuild 属性;TFM 是最常见条件维度。
  • 条件资产与编译符号配合?答:引用条件与 #if 符号分别控制依赖与代码。

04.6.4.2-015 RID 与运行时标识?

一句话结论

RID(Runtime Identifier)标识目标运行时平台(操作系统/CPU 架构),用于选择原生依赖与发布自包含部署;包内按 RID 提供原生资产。

概念解释

RID 形如 win-x64、linux-arm64,还原/发布按 RID 选取对应原生库。托管库通常不依赖 RID,原生互操作/自包含部署需要。

原理流程

  1. 项目/发布指定 RID。
  2. 还原选取 RID 匹配的原生资产。
  3. 发布产物按目标 RID 组装。

代码或图示

dotnet publish -r linux-x64 --self-contained

常见误区

  • 托管项目随意指定 RID:无原生依赖时 RID 影响有限,避免无谓限制。
  • 跨平台发布忽略 RID:原生库可能不带目标平台二进制。

追问

  • RID 与 TFM 区别?答:TFM 标识 .NET 框架版本;RID 标识操作系统/架构运行环境。
  • 可移植 RID?答:兼容系列 RID 可回退匹配具体资产;规则以 .NET RID 文档为准。

04.6.4.2-016 项目引用的资产传递与输出?

一句话结论

项目引用默认传递编译与运行资产;可通过 PrivateAssets/PublishAssets 等元数据控制哪些资产不向下游传递,避免多余依赖进入输出。

概念解释

被引用项目的依赖默认沿引用链传递;某些构建/分析资产只需在本项目生效,不应传递给下游。资产元数据控制传递边界。

原理流程

  1. 项目引用默认资产传递规则。
  2. 标记不传递的资产类型。
  3. 下游项目编译/输出只收到允许资产。

代码或图示

<ProjectReference Include="Lib.csproj">
  <PrivateAssets>all</PrivateAssets>
</ProjectReference>

常见误区

  • 分析器/构建资产意外传递:下游项目被不该有的规则影响。
  • 该传递的运行资产被排除:运行时缺程序集报错。

追问

  • 私有资产与公开资产?答:PrivateAssets 控制不传递内容;具体资产类别以 NuGet/MSBuild 规则为准。
  • 输出目录重复程序集?答:检查引用传递与包版本统一,避免多版本进入输出。

04.6.4.2-017 程序集边界与公共 API 设计?

一句话结论

程序集对外暴露的公共类型/方法构成公共 API;边界应精简稳定,内部实现用 internal 隔离,变更公共 API 需考虑版本兼容与下游影响。

概念解释

程序集是分发与版本单元。公共 API 一旦被下游依赖,破坏性修改代价高;内部实现不外露,便于独立重构。测试通过友元访问内部细节。

原理流程

  1. 划分对外契约与内部实现。
  2. 公共类型/方法保持稳定语义。
  3. 内部变化不穿透程序集边界。

代码或图示

公共 API(稳定契约) ← 程序集边界 → internal 实现(可重构)

常见误区

  • 把所有类型设 public:内部细节外泄,后续修改受兼容约束。
  • 公共 API 频繁破坏性变更:下游集成成本高。

追问

  • 公共 API 兼容性怎么维护?答:新增成员保持兼容,删除/改签名走版本升级与公告。
  • 程序集拆分依据?答:按稳定边界与复用需求;过细拆分增加引用管理成本。

04.6.4.2-018 项目模板与脚手架规范?

一句话结论

团队约定项目模板/脚手架:统一目录结构、props 配置、测试项目与命名规则;新建项目从模板复制,保证仓库内结构一致。

概念解释

模板固化分层命名、包引用基线、分析规则与测试组织。新成员按脚手架创建项目,避免结构与配置各自为政。

原理流程

  1. 沉淀标准项目模板与目录约定。
  2. 新建项目套用模板骨架。
  3. 评审检查结构与配置符合规范。

代码或图示

模板:csproj 基线 + props 引用 + 测试项目骨架 + 命名约定

常见误区

  • 每个新项目自由发挥:目录/配置不一致,后续治理成本高。
  • 模板包含业务逻辑:模板只放结构与约定,业务代码在项目内实现。

追问

  • 模板放哪维护?答:仓库内 templates 目录或内部 CLI 模板;随工程规范更新。
  • 脚手架与 CI 配合?答:CI 检查项目结构与必备配置,偏离规范阻断合并。