GitHub
代码协作与CI/CD
- 001入门GitHub 是什么:把本地仓库放进全世界的协作网络从「写好的项目只存在自己电脑上」的真实焦虑讲起,用 gh 与网页两条路完成建仓、首次推送与第一次 PR 预览,讲清 Git 与 GitHub 的分工、账户体系与首页导航,并给出新手最常见的六个报错对照表。
- 002中级账户注册与双因素认证(2FA)GitHub 账户注册、邮箱验证、密码策略与双因素认证(2FA)配置指南:安全意义、TOTP 原理与恢复方案。
- 003中级仓库创建、克隆、归档、删除GitHub 仓库创建、克隆、归档、删除的完整操作指南:从开新店到关店的全流程向导。
- 004中级SSH 与 HTTPS 远程配置SSH 与 HTTPS 远程配置对比、公钥配置、HTTPS+PAT 配置指南与故障排查。
- 005入门本地仓库连接 GitHub:init、远程关联与首次推送以「把本地项目放上 GitHub」为主线讲透三条起点路径(先 clone、后关联、gh 一步到位):git init 与 main 分支约定、origin 是什么、push -u 建立了什么、克隆自动做的三件事,附 not a git repository 与认证失败等真实报错对照表。
- 006入门Git 提交与推送:小步提交,按节奏推上 GitHub以「一个功能从写到推上 GitHub」的完整节奏讲 add / commit / push:暂存的挑选粒度(-p)、commit -am 陷阱、push -u 追踪关系、推送被拒的标准处置、force-with-lease 安全线,附 vim 卡住与 non-fast-forward 等七个真实报错对照表。
- 007入门Gitignore 配置.gitignore配置详解:忽略规则清单、语法、优先级、全局配置与官方模板库使用。
- 008入门GitHub 拉取与获取以对比驱动方式讲解 git pull 与 git fetch 的区别与适用场景,覆盖远程更新同步、远程跟踪分支与拉取冲突处理,适合零基础学习者。
- 009入门GitHub 合并与变基以对比驱动方式讲解 git merge 与 git rebase 两种分支整合路线的原理、适用场景与选择原则,覆盖快进合并、三方合并与交互式变基,适合零基础学习者。
- 010入门GitHub 冲突解决以问题驱动方式讲解 Git 合并冲突的产生原理、冲突标记解读、完整解决流程与预防策略,覆盖 merge/rebase/cherry-pick 冲突场景,适合零基础学习者。
- 011入门GitHub 标签管理以清单驱动方式按标签全生命周期讲解 git tag 的创建、查看、推送、删除与检出,覆盖附注标签与轻量标签的区别和语义化版本规范,适合零基础学习者。
- 012入门GitHub 远程仓库管理以多设备协作场景驱动讲解 git remote 系列命令(查看、添加、修改、删除远程关联),覆盖 origin/upstream 双远程、fork 工作流与凭证管理,适合零基础学习者。
- 013入门GitHub 历史与日志以侦探查案驱动方式讲解 git log 的各类查看姿势与 git diff、git show、git blame、git reflog 的取证技巧,覆盖历史筛选、差异对比与引用日志,适合零基础学习者。
- 014入门GitHub 暂存与回退以寄存柜与时光机类比驱动讲解 git stash 暂存系列与 git reset/revert/restore/clean 回退系列命令,覆盖软/混合/硬回退三档选择与撤销安全原则,适合零基础学习者。
- 015中级协作开发规范协作开发规范:Commit Message 约定、分支命名、PR 模板、代码审查清单与 CLA/DCO 合规。
- 016中级提交签名验证GitHub 平台侧的提交签名验证:verified 徽章判定条件、分支保护 required signatures、组织级强制策略、Dependabot 与机器人提交的签名例外、DCO/CLA 集成,附 FANDEX 开启提交验证演练与一把 SSH key 同时 push 与签名的方案。
- 017入门README 文件GitHub README文件深度解析:用"店铺招牌与产品说明书"的对比讲透README的结构、写作要点与开源项目最佳实践。
- 018中级分支模型与分支保护规则分支模型设计(GitHub Flow / Git Flow)、保护规则配置与强制策略。
- 019中级Pull Request 完整协作流程:从分支到合并的全生命周期以「给 FANDEX 仓库提交一个真实 PR」为主线走完 PR 全生命周期:建分支、推送、创建(含 Draft 与自动合并)、三种审查结论、三种合并策略、清理关闭,附 Fork 场景的 upstream 同步与四个专属坑,以及审查者安全清单。
- 020中级CODEOWNERS:让每个 PR 自动找到最懂这块代码的人从「20 人团队的 PR 全堆给管理员一个人审」这个真实问题切入,动手写一份 CODEOWNERS 并用分支保护让审查意见有强制力,讲清路径匹配规则、优先级语义与常见的「负责人没被指派」排查路径。
- 021入门组织、团队与仓库权限角色从「社团仓库升级为组织仓库」讲起:组织与团队的两层结构、仓库权限五级角色、权限叠加规则、组织级安全设置与 SSO/SAML 概念入门。
- 022中级Fork 工作流:给没有写权限的仓库提交你的第一个 PR以「给一个开源项目修复文档错误」这个真实任务切入,走完 fork、双远程配置、分支修改、PR、同步上游、冲突解决的完整链路,讲清 Fork 与 Branch 的本质区别和 force-with-lease 这条安全红线。
- 023中级Issues 模板、标签与里程碑Issues 模板配置、Labels 标签体系、Milestones 里程碑管理、自动化关闭关键词与项目板衔接。
- 024入门通知与订阅管理GitHub 通知与订阅管理:watching/订阅/忽略三态模型、仓库与 discussion 级订阅粒度、邮件与 Web 通知路由配置、watching 清单治理、CI 失败与安全告警的通知链路,附多仓库分流与组织默认策略治理方案。
- 025中级Projects 看板GitHub Projects深度解析:以"项目白板与便利贴"为主线,讲解表格/看板/时间线三种视图、自定义字段、内置自动化与洞察图表。
- 026入门WikisGitHub Wikis深度解析:围绕"团队知识沉淀"场景,讲解 Wiki 的启用、页面组织、侧边栏页脚、本地克隆编辑与维护最佳实践。
- 027入门DiscussionsGitHub Discussions深度解析:从"Issue 还是 Discussion 怎么选"的困惑切入,讲解论坛式讨论的分类体系、问答、公告、投票与维护者协作。
- 028入门社区健康文件GitHub社区健康文件深度解析:以"社区公约"清单为主线,逐一讲解 CONTRIBUTING、CODE_OF_CONDUCT、SUPPORT、SECURITY、CODEOWNERS 等文件与默认文件机制。
- 029入门开源许可证选择开源许可证对比与选择:MIT、Apache、GPL三大类许可证的权利义务对比表、选择方法与GitHub添加流程。
- 030中级依赖安全选项:你的项目里 95% 的代码不是你写的从「pnpm install 装进来上千个包,出事算谁的」这个真实问题切入,动手给仓库装好依赖安全基线:提交锁定文件、启用依赖图谱与 Dependabot 告警、加一个 Dependency Review 工作流,再讲清供应链攻击的三条路径与四道防线如何配合。
- 031中级Dependabot 实战:三个职责、一份配置、一条自动合并流水线从「告警响了几个月,依赖却没人升级」这个真实问题切入,动手给 pnpm monorepo 写好 dependabot.yml,讲清 Alerts、Security Updates、Version Updates 三个职责的区别,最后配一条「CI 通过即合并」的自动化流水线。
- 032中级密钥扫描与推送保护:密钥进了公开仓库,就当它已经泄露从「调试时把 API Key 硬编码进代码,push 完才想起来」这个真实事故切入,动手开启 Secret Scanning 与 Push Protection,讲清 GitHub 怎么认出密钥、被拦截后怎么处理、真泄露了按什么顺序补救,最后给出用 gh secret 管理密钥的正确姿势。
- 033中级CodeQL 代码扫描:让机器看懂「数据从哪流到哪」从「一行语法完全正常的代码,其实是 SQL 注入」这个真实问题切入,动手用 Default Setup 十分钟开启代码扫描,讲清 CodeQL 数据库与查询的原理、告警怎么读怎么关,以及什么时候才需要自定义查询。
- 034中级GitHub CopilotGitHub Copilot 深度解析:补全/Chat/agent mode/coding agent 四种工作形态、订阅计划、提示词工程、copilot-instructions、代码审查衔接与组织策略。
- 035进阶REST 与 GraphQL APIGitHub API详解:REST与GraphQL双路线对比(餐厅点餐类比)、认证方式、curl/gh api调用与速率限制。
- 036入门访问令牌与 GitHub Apps:一张类型图分清谁能替你操作仓库classic PAT 与 fine-grained PAT 的差异与迁移、Actions 的 GITHUB_TOKEN、GitHub App 与 OAuth App 的选型边界,配「CI 用哪种令牌」与「第三方 App 该批多少权限」两个决策场景。
- 037中级WebhooksGitHub Webhooks详解:按事件→Webhook→Payload→响应完整流程讲解订阅、投递、签名验证与服务器实现。
- 038中级GitHub PackagesGitHub Packages深度解析:从 npm/Docker 包管理原理讲起,把 GitHub Packages 讲成团队私有的"软件包超市",覆盖认证、发布、安装与 CI/CD 集成。
- 039中级CodespacesGitHub Codespaces 详解:云端开发环境原理(远程容器)、devcontainer 配置、预构建与使用。
- 040中级GitHub Pages 多站点方案GitHub Pages 静态站点部署方案:Jekyll、VitePress、Hugo 构建与发布。
- 041中级GitHub Actions 与 CI/CDGitHub Actions 与 CI/CD 总纲:以智能工厂流水线为类比,讲透 CI/CD 概念、workflow 文件结构(name/on/jobs/steps)、Actions 市场使用与工程最佳实践。
- 042中级Actions 触发器:on 字段决定你的流水线什么时候跑从「为什么改一行文档也触发了一次完整部署」这个真实浪费切入,动手为一个仓库写出 push / pull_request / schedule / workflow_dispatch 的完整触发配置,讲清过滤条件、pull_request_target 的安全边界与 GITHUB_TOKEN 不递归触发的机制。
- 043进阶Actions 矩阵构建GitHub Actions矩阵策略原理详解:从一次配置多环境测试的痛点出发,深入 strategy.matrix 语法、include/exclude、fail-fast 与动态矩阵。
- 044中级Actions 缓存依赖GitHub Actions缓存机制问题驱动详解:从每次CI都重新下载依赖太慢的痛点切入,讲透 actions/cache 用法、缓存键设计、命中逻辑与依赖加速最佳实践。
- 045中级Actions 制品传递GitHub Actions制品(Artifacts)流程驱动详解:按"上传→下载→过期管理"完整流程,讲透 upload-artifact、download-artifact 与跨 Job/跨工作流传递。
- 046进阶Actions 环境部署:生产密钥为什么要单独锁一个门从「生产数据库密码躺在仓库级 Secrets 里,任何 job 都能读」这个真实隐患切入,动手创建 environment、配保护规则和审批流,讲清环境级密钥覆盖规则、多环境渐进部署工作流与并发防踩踏。
- 047进阶Actions 自托管运行器GitHub Actions自托管运行器对比驱动详解:GitHub托管运行器 vs 自托管运行器全程对比,覆盖注册安装、标签路由、安全加固与运维管理。
- 048入门Actions 复用与供应链安全:可复用工作流、组合动作与权限最小化以「三个服务仓库各抄一份几乎相同的 CI」与「第三方 action 被投毒」两个真实痛点切入,动手抽取可复用工作流(workflow_call)与组合动作(composite action),并给工作流加上权限最小化、SHA 固定与 OIDC 三道保险,讲清复用机制的服务端展开原理与 fork PR 的攻击面。
- 049中级GitHub CLIGitHub CLI(gh)总览:遥控器心智模型、命令族导航(auth/repo/pr/issue/release/workflow/gist/search/api/extension/alias)、上手路径与常见错误速查。
- 050进阶gh CLI 脚本化与自动化gh CLI 脚本化与自动化组合:--json + jq 的输出字段选择与模板、shell 脚本与 GitHub Actions 中的自动化模式(gh pr checks 判定、gh run watch、批量 Issue 治理)、token 最小权限与脚本安全习惯、常见脚本错误对策。
- 051入门GitHub CLI 认证配置GitHub CLI(gh)安装与认证的完整教学:交互式登录、Token 登录、多账户切换、SSH 密钥管理与 CI 环境配置。
- 052中级gh pr 实战:一条 PR 从创建到合并的全命令行操作以「给仓库修一个 bug 并合并」这个真实任务为线索,把 gh pr 的 create、view、checkout、checks、review、merge 六组命令串成完整闭环,覆盖 Conventional Commits 提交、自动合并、审查三态与合并策略选择。
- 053入门GitHub CLI Issue 管理用 gh 命令行管理 Issue 全流程:创建与模板、查询过滤、评论编辑、关闭原因、Issue 转分支、批量操作与治理命令。
- 054入门GitHub CLI 仓库管理用 gh 命令行管理仓库生命周期:创建与本地项目发布、克隆、Fork 与同步、元信息编辑、归档、转移与删除。
- 055入门gh release 发布命令速查手册以"从代码到正式发布"的完整旅程为主线,讲解 gh release 系列命令,包括创建、查看、上传下载、编辑与删除发布,配以原理讲解、错误对策。
- 056入门gh workflow 工作流命令速查手册以"运行一个 workflow 的完整生命周期"为主线,讲解 gh workflow 系列命令,涵盖查看、手动触发、参数传递、启用与禁用,配以原理讲解、错误对策。
- 057入门gh gist 代码片段命令速查手册以"三个真实使用场景"为主线讲解 gh gist 系列命令:快速分享代码、备份个人笔记、管理与复用片段,涵盖创建、查看、编辑、克隆、重命名与删除,配以原理讲解、错误对策。
- 058入门gh extension 扩展命令速查手册以"手机 App 应用商店"为线索讲解 gh extension 系列命令,涵盖搜索、安装、升级、移除、浏览与创建扩展,配以原理讲解、安全提示、错误对策。
- 059入门gh api 调用命令速查手册原理驱动讲解 gh api:先讲清 REST 与 GraphQL API 是什么,再讲 gh api 如何完成认证请求、传参、输出处理、分页与 GraphQL 查询,配以错误对策。
- 060入门gh search 搜索命令速查手册问题驱动讲解 gh search:从"怎么快速找到想要的仓库、代码、Issue、PR、提交"等真实问题切入,涵盖 repos/code/issues/prs/commits 五类搜索与常用过滤选项,配以错误对策。