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

09.1 阶段 0:环境与工程基础

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

本页目录

一、阶段定位

阶段 0 只解决"在本机把 .NET 跑起来"这一件事:装好 SDK、认得出 CLI 的输入输出、建立解决方案与项目结构、把代码纳入 Git。它不要求写业务逻辑,只要求每一条命令敲下去之后,你能解释产物去了哪里、为什么成功或失败。

为什么这是独立的一关:.NET 工具链与 Java 的 Maven、Node 的 npm 在目录约定上差别明显。dotnet new 直接生成可编译的项目骨架;dotnet build、dotnet run 会隐式执行还原;项目之间的引用写在 .csproj 里而不是"类路径"上。带着 Java 或 Node 的直觉硬写,第一次还原就会卡在 assets 文件相关报错。

与前后阶段的衔接:往上,本阶段默认你会用命令行、看得懂 HTTP 方法与状态码;往下,阶段 1 C# 语言核心 会在这个骨架里写第一个类。如果本阶段结束时分不清"运行时版本"与"SDK 版本",阶段 1 引入 NuGet 包时就会反复遇到"该包不支持当前目标框架"而无从定位。

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

  • 分不清 SDK 与运行时版本:执行 dotnet --list-sdks 与 dotnet --list-runtimes 后,说不出两者数量为何不同、为什么机器上多个版本并存,也不知道 dotnet --version 显示的是哪一个。
  • 随意改项目文件导致还原失败:手工编辑 .csproj 后出现 dotnet restore 报错、obj/project.assets.json 无法重新生成,或 dotnet run 提示找不到目标框架。
  • 在错误目录执行命令:在已存在项目的目录里执行 dotnet new console,或在解决方案根目录执行 dotnet run 时得到"找到多个可运行项目"的报错而不会指定项目。

二、阶段目标与投入

学完本页,应当能用可观察的命令输出证明以下六条能力:

能力目标(可验证的行为) 验证方式
能说清 SDK 与运行时的区别,并用 global.json 锁定版本 dotnet --list-sdks、dotnet --list-runtimes 输出能逐项解释
能从零创建控制台项目并运行 在空目录执行 dotnet new console 后 dotnet run 输出预期文本
能建立解决方案与多项目结构 dotnet sln add 后主项目能 dotnet build 成功并引用类库
能添加并更新 NuGet 包 dotnet add package 后 obj/project.assets.json 出现该包
能把代码提交到 Git git log 有至少两条提交,.gitignore 排除了 bin/、obj/
能说清 build 与 publish 的产物差异 对比两次产物目录,指出 publish 多了运行时或框架依赖清单

建议学时:

  • 全职(每天有效学习 4–6 小时):1 周,约 25–30 小时。其中安装与熟悉 CLI 6 小时、工程结构与 Git 12 小时、命令行与 HTTP 概念 6 小时、复盘 4 小时。
  • 在职(每天 2 小时、周末补 4 小时):2 周,约 30 小时。按"一个模块两天"的节奏,不要一次看完全部命令再动手。

学时分配建议:SDK 与版本管理 15%、dotnet CLI 命令 25%、解决方案与项目结构 25%、NuGet 与还原 15%、Git 与命令行/HTTP 概念 20%。

三、先修自检

进入本阶段前逐条自检;任何一条做不到,先补齐再往下走,否则示例会看不懂。

先修项 合格标准 不合格时怎么补
命令行基础 能在终端切换目录、查看文件列表、用 where(Windows)或 which(macOS/Linux)定位程序 先熟悉终端的目录导航与文件查看命令
Git 概念 知道"仓库、提交、远程"三个词的含义,能 git init、git add、git commit 先跑通一个空仓库的三次提交
HTTP 基础 知道 GET 与 POST 的区别,认识 200、404、500 三个状态码 阅读 HTTP 方法与状态码的入门说明
文本编辑器 能用编辑器保存纯文本文件并理解编码 确认编辑器保存为 UTF-8 无 BOM
进程与端口 知道一个程序监听端口是什么意思 回到 01.1 操作系统 补课

四、知识地图

"掌握程度"分三档:了解(知道有这个东西、能查到)、会用(能写对、能调通)、能讲清原理(能解释产物与边界条件)。

模块 知识点 掌握程度 对应题库章节
SDK 与运行时 SDK/Runtime 区别、多版本并存、global.json 锁定 能讲清原理 01.1 操作系统
dotnet CLI new/restore/build/run/test/publish、-c Release、--project 会用 01.1 操作系统
解决方案结构 .sln、.csproj、项目引用、输出目录约定 会用 01.1 操作系统
NuGet 添加包、版本约束、还原、私有源概念 会用 01.1 操作系统
Git 与命令行 提交、忽略 bin//obj/、工作目录概念 会用 01.1 操作系统
HTTP 与状态码 GET/POST、200/404/500、请求与响应体 了解 01.1 操作系统

进度管理建议:把这张表复制到笔记里,每学完一个模块把"掌握程度"往下调一档;三档都到位再进 阶段 1。《知识点全清单》是更细的全量打勾清单,本页只列本阶段重点。

五、分模块精讲

5.1 SDK 与运行时的区别、版本管理

为什么需要它:很多新人把"装了 .NET"理解成只装一个东西,结果机器上同时存在 SDK、桌面运行时、ASP.NET Core 运行时三套清单,版本号还互相覆盖。不先分清三者,后面"为什么 dotnet build 报错说找不到目标框架"就无法解释。

核心机制:

  • SDK 包含编译器、MSBuild、dotnet CLI 与运行时,是"开发机"的完整工具集;dotnet build 只能在装了 SDK 的机器上跑。
  • 运行时(Runtime) 只负责运行已编译好的程序,分三类:基类库运行时、ASP.NET Core 运行时、桌面运行时;服务器上通常只装运行时。
  • 机器上可以并存多个版本:dotnet --list-sdks 列出全部 SDK,dotnet --list-runtimes 列出全部运行时;CLI 默认使用"最高版本的 SDK",除非被 global.json 覆盖。
  • global.json 放在解决方案根目录,用 sdk.version 锁定本次构建使用的 SDK 版本,保证团队成员、CI 与本机构建结果一致。
  • dotnet --version 显示的是"当前生效的 SDK 版本",受 global.json 影响;dotnet --info 显示全部详情。

最小可运行示例:

# 查看当前机器上的 SDK 与运行时清单
dotnet --list-sdks
dotnet --list-runtimes

# 在解决方案根目录锁定 SDK 版本(major.minor 与安装一致)
dotnet new globaljson --sdk-version 10.0.100
# 该命令生成 global.json,内容形如:
# { "sdk": { "version": "10.0.100" } }
{
  "sdk": {
    "version": "10.0.100",
    "rollForward": "latestMajor"
  }
}

常见坑:

现象 原因 修法
dotnet build 报 "The current .NET SDK does not support targeting .NET 10.0" 本机 SDK 版本低于目标框架版本 安装对应 SDK,或用 global.json 指向已安装版本
团队成员构建结果不一致 没有 global.json,各人用了不同 SDK 新增 global.json 并提交到仓库
dotnet run 提示 "It was not possible to find any installed .NET SDKs" 只装了运行时没装 SDK 安装 SDK,或检查 global.json 指向了未安装的版本

面试考法:常见问法是"开发机和生产服务器装的 .NET 有什么区别"。要答出:开发机装 SDK,服务器装运行时;生产发布又分"框架依赖部署"(服务器自带运行时、包体小)与"自包含部署"(把运行时打进包、服务器不装 .NET)。追问常落到"为什么 CI 要锁 SDK 版本"。

5.2 dotnet CLI 常用命令

为什么需要它:dotnet CLI 是所有后续阶段的入口,命令记错参数会直接导致"在错误目录构建错误项目"。本阶段把每条命令的产物讲清楚。

核心机制:

  • dotnet new console:在当前目录生成 Program.cs 与 .csproj;目录名即项目名。
  • dotnet restore:根据 .csproj 的包引用还原 NuGet 依赖到 obj/project.assets.json;build、run、test 会隐式先执行 restore。
  • dotnet build:编译输出到 bin/$(Configuration)/$(TargetFramework)/;-c Release 指定发布配置。
  • dotnet run:编译并运行;它是 build + 执行产物的合体,调试用。
  • dotnet test:查找解决方案里的测试项目并执行。
  • dotnet publish -c Release:输出可部署产物到 bin/Release/$(TargetFramework)/publish/,包含依赖清单;-r linux-x64 指定运行时标识符(RID)可做自包含发布。

最小可运行示例:

# 新建一个控制台项目并运行
dotnet new console -n Hello
cd Hello
dotnet run                       # 隐式还原 + 编译 + 执行
dotnet build -c Release         # 仅编译 Release
dotnet publish -c Release        # 产出 publish 目录,可直接部署

常见坑:

现象 原因 修法
dotnet run 报 "Found multiple projects" 在解决方案根目录或多项目目录执行,CLI 不知道跑哪个 加 --project Hello/Hello.csproj 指定项目
修改代码后运行结果不变 运行的是旧产物或 bin 残留 删除 bin/、obj/ 后重新 dotnet run
dotnet test 说找不到测试 测试项目没有引用测试 SDK,或不在解决方案里 确认 .csproj 含 Microsoft.NET.Test.Sdk 并已 dotnet sln add

面试考法:常见问法是"dotnet build 与 dotnet publish 的产物差在哪"。要答出:build 只产出编译好的 dll 与依赖引用,publish 把运行所需的依赖、配置、目标运行时清单一起整理到 publish/ 目录,可整体拷到目标机器运行。追问常到"框架依赖与自包含发布的包体差异"。

5.3 解决方案与项目结构

为什么需要它:真实项目从不只有一个 .csproj。控制台主程序、业务类库、测试项目是三个项目,它们靠解决方案与项目引用串起来。不理解这个结构,后续"主项目引用了类库却找不到命名空间"会反复出现。

核心机制:

  • 解决方案文件(.sln)是项目的容器,本身不参与编译,只记录"哪些项目属于这个仓库、构建顺序由依赖推导"。
  • 一个项目 = 一个目录 = 一个 .csproj;项目之间用 <ProjectReference> 引用,而不是拷贝源码。
  • 目录约定:src/ 放产品代码,tests/ 放测试代码,解决方案 .sln 放根目录。
  • 项目引用在编译期按依赖顺序传递:主项目引用类库,测试项目引用主项目。

最小可运行示例:

# 建立标准结构:一个解决方案 + 两个项目
dotnet new sln -n Workspace
dotnet new classlib -o src/Workspace.Core
dotnet new console -o src/Workspace.App

# 把项目加入解决方案
dotnet sln add src/Workspace.Core/Workspace.Core.csproj
dotnet sln add src/Workspace.App/Workspace.App.csproj

# 主项目引用类库
dotnet add src/Workspace.App/Workspace.App.csproj reference src/Workspace.Core/Workspace.Core.csproj
<!-- src/Workspace.App/Workspace.App.csproj 的引用部分 -->
<ItemGroup>
  <ProjectReference Include="..\Workspace.Core\Workspace.Core.csproj" />
</ItemGroup>

常见坑:

现象 原因 修法
主项目 using Workspace.Core 报找不到命名空间 没加 <ProjectReference> dotnet add ... reference ...
改了类库代码,主项目行为没变 项目引用没生效或构建缓存 删除 bin/、obj/ 后重新 dotnet build
把 .sln 拷到别处打不开 .sln 内是相对路径,移动后路径错位 整个目录一起移动,不要单拷 .sln

面试考法:常见问法是"一个解决方案里通常有哪些项目、为什么要把类库和主程序分开"。要答出:分层让业务逻辑可被测试项目直接引用、可被多个入口复用;测试不依赖进程启动,只引用类库就能单测。

5.4 NuGet 包与还原

为什么需要它:NuGet 是 .NET 的依赖分发渠道。dotnet add package 会改 .csproj 并触发还原;不理解还原,第一次断网或换私有源就会卡住。

核心机制:

  • NuGet 包是 .nupkg(zip),包含 dll 与依赖清单;dotnet add package <id> 写入 <PackageReference> 并还原。
  • 还原读取 .csproj 的版本约束,解析传递依赖,把结果写进 obj/project.assets.json;这是构建的输入。
  • 版本约束写法:[6.0.0] 精确版、6.0.* 浮动版、>=6.0.0 区间;浮动版会让还原结果不可复现。
  • 还原失败常见于网络(访问 nuget.org 超时)或私有源未配置。

最小可运行示例:

# 给类库添加一个包,并指定版本
dotnet add src/Workspace.Core/Workspace.Core.csproj package Newtonsoft.Json --version 13.0.3

# 单独触发还原(build 会自动做,但排查时手动跑便于看错误)
dotnet restore src/Workspace.Core/Workspace.Core.csproj

常见坑:

现象 原因 修法
dotnet restore 超时或 403 网络无法访问 nuget.org,或需要私有源 配置国内镜像源或公司私有源到 nuget.config
还原后 project.assets.json 仍缺失 obj/ 被手动删除或路径含特殊字符 删除 bin/、obj/ 后重新 dotnet restore
团队成员还原到不同版本 用了浮动版本约束 把版本固定为精确版,提交 packages.lock.json(如启用)

面试考法:常见问法是"NuGet 的传递依赖是怎么解析的"。要答出:还原时把直接依赖与依赖的依赖做版本仲裁,同一包取满足约束的最高版本,结果固化在 assets 文件里;冲突时在输出日志里显示降级或升级。

5.5 Git 与忽略构建产物

为什么需要它:bin/、obj/ 是构建产物,会被每次构建重新生成,且体积大、内容随机器变化。把它们提交进仓库会让 diff 无法阅读。

核心机制:

  • .gitignore 告诉 Git 忽略哪些路径;bin/、obj/、.user 文件是 .NET 项目的标准忽略项。
  • dotnet new gitignore 可直接生成一份适合 .NET 的 .gitignore。
  • 提交历史应能让别人 git clone 后一条 dotnet build 跑通——意味着产物不进仓库,global.json 要进仓库。

最小可运行示例:

# 在仓库根目录生成标准 .gitignore
dotnet new gitignore
git init
git add .
git commit -m "chore: 初始化 .NET 解决方案骨架"

常见坑:

现象 原因 修法
仓库里出现大量 .dll、.pdb 没配 .gitignore 就提交 补 .gitignore 后 git rm -r --cached bin obj
clone 后别人 build 报错 提交了 obj/project.assets.json 导致冲突 从版本库移除 obj/,保留 .csproj

面试考法:常见问法是"哪些文件该进版本库、哪些不该"。要答出:源码、.csproj、.sln、global.json、nuget.config 进仓库;bin/、obj/、用户本地配置不进仓库,靠还原与构建重新生成。

5.6 命令行、HTTP 与第一个网络请求

为什么需要它:后续 Web API 阶段要用 HTTP 测试接口。本阶段先建立"请求方法—状态码—响应体"的直觉,否则调试时看到 404 不知道是路由错了还是服务器没起。

核心机制:

  • HTTP 方法:GET 取数据、POST 提交数据、PUT 整体更新、DELETE 删除;状态码:2xx 成功、4xx 客户端错误、5xx 服务端错误。
  • 一个 Web 程序启动后监听某端口(如 5000),用浏览器或命令行工具访问 http://localhost:5000 才能到达它。
  • 常用命令行工具:Windows PowerShell 的 Invoke-WebRequest,或跨平台的 curl。

最小可运行示例:

# 启动一个最简单的 Web 项目(后续阶段会深入)
dotnet new web -o src/Workspace.Web
cd src/Workspace.Web
dotnet run
# 另开一个终端访问
curl http://localhost:5000

常见坑:

现象 原因 修法
curl 报"无法连接" 服务没启动,或监听端口与访问端口不一致 看启动日志里的 Now listening on: http://...
访问返回 404 服务器在,但该路径没有对应接口 确认路由;本项目默认只在 / 有响应
HTTPS 证书警告 本机开发证书未信任 执行 dotnet dev-certs https --trust

面试考法:常见问法是"404 与 500 的区别"。要答出:404 是路由层没匹配到资源(请求到了应用但没有对应端点),500 是请求到了应用但处理过程中抛了未捕获异常。两者排查路径完全不同。

六、分层练习

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

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

练习 要求 验收标准 预计耗时
装 SDK 并查看清单 安装 SDK,执行三条查看命令 dotnet --list-sdks 有输出,能说清 SDK 与 Runtime 各几条 1 小时
建控制台项目 dotnet new console 后改 Console.WriteLine 输出自己的名字 dotnet run 打印名字 0.5 小时
建解决方案多项目 一个 sln、一个类库、一个主程序,类库加一个方法被主程序调用 dotnet build 成功,运行时打印类库方法的返回值 1.5 小时
添加 NuGet 包 给类库加一个 JSON 序列化包并调用 代码里能 using 该包命名空间 1 小时
Git 提交与忽略 配 .gitignore,提交两条记录 git log 有记录,bin/、obj/ 不在提交列表 1 小时

6.2 改造型(给出现成结构,改出正确行为)

练习 要求 验收标准 预计耗时
锁定 SDK 版本 加 global.json,切换 SDK 版本看 dotnet --version 变化 改版本号后生效,不匹配时给出明确报错 1 小时
修复找不到命名空间 给定一个漏加 <ProjectReference> 的工程,补全引用 主程序能 using 类库命名空间并编译通过 1 小时
从提交历史移除产物 给定误提交了 bin/ 的仓库,清理并重新提交 git ls-files 不含 bin/、obj/ 1.5 小时
指定运行项目 在多项目目录下让 dotnet run 正确指向主程序 用 --project 参数成功运行 0.5 小时

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

练习 要求 验收标准 预计耗时
标准解决方案骨架 设计 src/、tests/、build 脚本的目录约定,写一份 README 说明如何跑 新人 clone 后按 README 一条命令跑通 3 小时
版本与依赖规范 写明团队用 SDK 锁定、精确版本约束、私有源配置约定 新成员按文档 30 分钟内装好环境 3 小时
本机开发脚本 写一个脚本一键还原、构建、跑测试 脚本在干净 clone 上执行成功 2 小时

七、排障表

现象 可能原因 排查步骤 解决办法
dotnet build 报找不到目标框架 SDK 版本低于 TargetFramework dotnet --info 看 SDK;对照 csproj 里的目标框架 装对应 SDK 或用 global.json 指向已装版本
dotnet run 报 "Found multiple projects" 在多项目目录直接运行 dotnet sln list 看有哪些项目 加 --project 指定具体 csproj
还原超时或 403 访问 nuget.org 受阻 看报错里的源地址 配置镜像或私有源到 nuget.config
改了代码运行结果不变 bin/ 残留旧产物 删除 bin/、obj/ 后重跑 重新 dotnet run
主项目 using 类库报命名空间不存在 漏加项目引用 检查 csproj 是否有 <ProjectReference> dotnet add ... reference ...
HTTPS 访问有证书警告 开发证书未信任 看启动日志的 HTTPS 提示 dotnet dev-certs https --trust
提交历史里全是 dll 没配 .gitignore git ls-files 看跟踪的文件 补 .gitignore 并从缓存移除产物

八、出口条件

全部勾选后再进入 阶段 1 C# 语言核心。

  • [ ] 能说清 SDK 与运行时的区别,并用 global.json 锁定过版本
  • [ ] 能从零建出 sln + 类库 + 主程序 的结构,dotnet build 成功
  • [ ] 能添加 NuGet 包并解释还原发生了什么
  • [ ] .gitignore 正确排除 bin/、obj/,git log 有提交记录
  • [ ] 能对比 dotnet build 与 dotnet publish 的产物差异
  • [ ] 能用命令行工具访问本机 Web 服务并读懂 200/404/500
  • [ ] 排障表里的七个现象,随机抽三个能在 5 分钟内给出排查路径

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

  1. SDK 与运行时的区别是什么?生产服务器为什么通常只装运行时?
    • 要点:SDK 含编译器与 CLI,只用于开发;运行时只运行已编译产物;服务器装运行时是为了减小体积与攻击面,发布用框架依赖或自包含两种模式。
  2. dotnet build 与 dotnet publish -c Release 的产物差在哪?
    • 要点:build 只产出 dll 与依赖引用;publish 整理出可部署目录,含依赖清单与配置,可整体拷贝运行。
  3. dotnet run 在解决方案根目录报"找到多个项目",怎么修?
    • 要点:用 --project 指定具体 csproj;根目录不是可执行项目。
  4. 为什么 bin/、obj/ 不该进版本库?
    • 要点:它们是构建产物,每次重新生成,且随机器变化;进库会让 diff 失控、clone 后冲突。
  5. global.json 解决什么问题?
    • 要点:锁定团队与 CI 的 SDK 版本,避免不同人用不同 SDK 导致构建结果不一致。
  6. 访问 Web 服务返回 404 与 500,排查路径有何不同?
    • 要点:404 查路由是否匹配(请求到了应用但没端点);500 查应用内部异常堆栈(请求到了端点但处理出错)。