工程起步与工作流

学会开车,第一课不是内燃机原理,是”这是刹车,这是油门,踩离合换挡”。

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