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