工程起步与工作流
学会开车,第一课不是内燃机原理,是”这是刹车,这是油门,踩离合换挡”。
10-getting-started/ 的定位就是这门驾校第一课——回答一个问题:一个工程师第一天加入真实项目,需要具备什么。不是学计算机科学,不是理解底层原理,是能在真实环境里开始干活:打开终端不慌、用命令行不费劲、用 Git 不出事、跟团队协作不拖后腿、不会因为安全疏忽闯祸。
这个定位决定了两件事:深度有上限(够用即止,不往底层挖),内容有边界(不是工具百科,是开发者起步的装备清单)。更深的系统原理、架构、安全工程和平台工程,分别在 40-systems/、50-architecture/、80-security/ 和 60-platform/ 里。
一、目录
本区域共 6 个模块,覆盖从零到能高效参与真实项目所需的全部地基。
10-getting-started/
│
├── 10-environment/ "装好开发环境"
│ ├── 01-终端与 Shell 环境.md
│ ├── 02-编辑器入门.md
│ └── 03-Dotfiles 管理.md
│
├── 20-cli/ "学会命令行"
│ ├── 01-命令行哲学.md
│ ├── 02-Shell.md
│ ├── 03-PowerShell.md
│ ├── 04-正则表达式.md
│ └── 05-数据格式.md
│
├── 30-git/ "用好 Git"
│ ├── 01-从零上手,先用起来.md
│ ├── 02-内容寻址数据库与四种对象.md
│ ├── 03-三棵树、引用系统与本地时间机器.md
│ ├── 04-分布式协作:远程、Fork 与上下游.md
│ ├── 05-Merge、Rebase 与分支策略.md
│ ├── 06-从工具到基础设施:演进与现代范式.md
│ └── 07-安全实践、协作规范与工具生态.md
│
├── 40-collab/ "参与真实项目"
│ ├── 01-开源生态与社区.md
│ ├── 02-参与开源.md
│ ├── 03-Code Review.md
│ └── 04-技术写作与沟通.md
│
├── 50-habits/ "好习惯"
│ ├── 01-SSH.md
│ ├── 02-安全实践.md
│ └── 03-开发者的血泪守则.md
│
└── 60-toolbox/ "提升日常效率"
├── 01-工具箱.md
├── 02-网络与调试.md
└── 03-任务自动化.md二、模块定位
10-environment/ — 开发环境的基础设施。终端选什么、Shell 配什么、编辑器怎么用到够用为止、配置文件怎么跨机同步。编辑器篇以 Vim 等终端编辑器为主线——SSH 进服务器、容器内编辑这些场景绕不过去;同时提及 VSCode、JetBrains 等主流 GUI 编辑器,它们是正经的长期选项,十年后还在,选哪条路都没问题。
20-cli/ — 命令行素养。Unix 哲学、Shell 脚本(核心与进阶合一)、PowerShell(Windows 现代工具链的核心)、正则表达式、常见数据格式。这是所有后续操作的语言基础。
30-git/ — Git 的完整认知体系。从日常操作到底层对象模型,从分布式协作到现代工作流,从分支策略到安全实践。这是目前区域内建设最完整的模块。
40-collab/ — 在团队和开源社区里工作。第一篇先看清楚当前计算机科学领域的开源生态(全球基金会、主流社区、中国的开源力量),再讲怎么参与、怎么做 Code Review、怎么写技术文档。这里关注的不是 Git 命令,是人与人之间协作的方式。
50-habits/ — 好习惯。SSH 配置和安全实践是地基;第三篇是每个开发者都踩过的那些坑——备份没做、生产上直接改、凭证提交进了仓库、改了什么记不清楚、rm 跑错了目录。不是不知道,是当时觉得”就这一次”。这篇要说的是:怎么把这些教训变成不需要思考的自动行为。
60-toolbox/ — 提升日常效率的工具,CLI 和 GUI 都算。不是工具大全,是按场景组织的推荐:值得长期使用的命令行工具和 GUI 应用、网络诊断和调试、任务自动化。够用的深度,不做参数手册。
三、阅读路径
路径一:从零开始,第一周上手
10-environment(先把环境装好,能打字能运行)
→ 20-cli/01-02(命令行哲学 + Shell)
→ 30-git/01(Git 先用起来)
→ 50-habits/01(SSH 配好,能连 GitHub)路径二:环境已有,补完基础
20-cli(整个模块,补命令行盲区)
→ 30-git/02-04(Git 底层原理)
→ 40-collab(了解团队协作规范)路径三:已经会用,提升工程效率
30-git/05-07(分支策略 / 现代工作流 / 安全)
→ 40-collab/03(Code Review)
→ 60-toolbox/(工具提速)四、与其他系列的关联
- Linux 系统 MOC — Shell 和 CLI 是 Linux 日常操作的入口;进程、文件、网络的底层原理在 40-systems
- 编程语言与软件构造 MOC — CLI 工具链(包管理、构建、测试运行器)是编程工程实践的操作底座
- 软件工程与架构 MOC — Git 工作流、开源协作规范是工程治理实践的基础;Conventional Commits 是 ADR 在提交级别的体现
- 安全工程 MOC — SSH 密钥管理和 Secret 扫描是安全工程的开发者日常入口;系统性安全工程在 80-security