GitHub 高频功能
实用指南

从日常使用到高效协作

仓库管理 · Issue & PR · Actions · 代码搜索 · 项目发现

概览

GitHub 高频功能一览

真正高频使用的功能大概只有十几个，掌握这些就够了

📦

仓库管理

创建、设置、协作者

🔍

代码搜索

浏览、搜索、Blame

📋

Issue

任务追踪与问题管理

🔀

Pull Request

代码审查与合并

⚙️

Actions

CI/CD 自动化

🌐

Pages

免费静态网站托管

🏷️

Releases

版本发布管理

🔧

CLI

终端命令行操作

基础

仓库（Repository）
管理

点击右上角"+"号 → New repository，做三个决定即可

①
仓库名称——小写字母加连字符
②
Public / Private——按需选择可见性
③
初始化——README + .gitignore + LICENSE

基础

仓库设置中的关键选项

Settings 标签页中最常用的四个功能

🌿

默认分支

Settings → Branches 修改默认分支名称，通常为 main

🛡️

分支保护

设置规则：合并前必须通过 PR、至少一人审批

👥

Collaborators

邀请协作者直接推送代码，无需 Fork → PR 流程

⚠️

Danger Zone

修改可见性、转移仓库、删除仓库——不可逆，谨慎操作

浏览

在线浏览代码

→
点击文件直接查看，Markdown 自动渲染
→
点击行号高亮单行，URL 自动更新
→
Shift + 点击高亮一个范围
→
"Raw"按钮获取原始文件内容

💡 按 . 键打开 github.dev 在线编辑器（VS Code 网页版）

搜索

代码搜索 & Blame

搜索过滤语法

语法	作用
language:python	按编程语言过滤
path:src/	按文件路径过滤
extension:yml	按文件扩展名过滤
repo:facebook/react	指定仓库搜索
org:google	指定组织搜索

Blame 视图

每一行代码旁边标注了提交者、时间和提交信息——快速回答"这行代码为什么这样写"

协作

Issue
任务与问题管理

GitHub 上最通用的协作单元，远不止"报告 Bug"

🏷
Labels——bug enhancement good first issue
🎯
Milestones——归入目标，自动显示完成百分比
👤
Assignees——指派负责人
🔗
关联 PR——Closes #123 自动关闭 Issue

核心

Pull Request 完整流程

代码在合并前必须经过审查——这是 GitHub 协作的核心

1

推送分支到 GitHub

页面出现黄色横幅提示创建 PR

2

填写 PR 描述

回答：做了什么改动 + 为什么做

3

代码审查

行内评论 · Suggestion · Approve / Request changes

4

合并 ✓

选择合并策略 → Merge

PR

三种合并策略

团队通常统一选择一种，避免混用

Merge commit

创建一个合并提交，保留完整历史

Squash and merge

压缩为一个提交，主分支更干净

Rebase and merge

逐个应用提交，保持线性历史

💡 Draft PR——代码还在开发中？创建 Draft PR，团队可以提前看进度，准备好后转为正式 PR

自动化

GitHub Actions
自动化工作流

内置 CI/CD 工具，在特定事件发生时自动执行任务

name: Tests
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm test

✓ 自动测试

每次提交自动跑测试

🚀 自动部署

合并后自动发布上线

功能

GitHub Pages & Releases

🌐 GitHub Pages

把仓库中的静态文件发布为网站

→
Settings → Pages 选择发布源
→
地址：用户名.github.io/仓库名
→
适用：博客、文档、作品集、简历

🏷️ Releases

为项目的稳定节点创建版本标记

选择 Tag → 填写说明 → 上传附件 →"Generate release notes"一键生成变更说明

效率

GitHub CLI —— 终端里操作 GitHub

不需要打开浏览器，一行命令搞定

// 仓库与 PR
$ gh repo create my-project --public
$ gh repo clone owner/repo
$ gh pr create --title "搜索功能"
$ gh pr review 42 --approve
$ gh pr merge 42

// Issue、Actions、Release
$ gh issue create --title "Bug" --label "bug"
$ gh issue list --label "bug"
$ gh run list
$ gh run view 12345
$ gh release create v1.0.0

# 安装： brew install gh → gh auth login

管理

Projects · 通知 · 个人主页

📊 Projects 看板

内置项目管理工具

→
Board 看板视图
→
Table 表格视图
→
与 Issue/PR 自动联动

🔔 通知管理

默认通知太多？精细控制

→
推荐：Participating only
→
核心项目：All Activity
→
用 reason: 过滤来源

👤 个人主页

你的技术名片

→
Profile README
→
Pinned Repos（最多 6 个）
→
贡献图（绿色格子图）

安全

安全相关功能

保护你的账户和代码

🔑 SSH 密钥

配置后不再需要每次输入密码

$ ssh-keygen -t ed25519
$ cat ~/.ssh/id_ed25519.pub
# 复制到 GitHub Settings → SSH keys

🎫 Personal Access Token

脚本调用 API 时使用 PAT 代替密码

→
推荐 Fine-grained tokens
→
限制特定仓库和权限

🤖 Dependabot

自动扫描依赖的安全漏洞

✓
发现漏洞自动创建 PR
✓
默认开启，无需配置

探索

发现与探索优秀项目

找到高质量项目并从中学习，本身就是一种重要能力

🔥 Trending

按日/周/月展示 Star 增长最快的项目

📚 Collections

官方编辑团队整理的主题合集

🏷️ Topics

按主题标签浏览，按 Star 数排列

探索

如何评估一个项目的质量

打开一个陌生仓库，快速判断是否值得投入时间

⭐
Star 数——社区认可度的粗略参考
🕐
最近提交——半年无更新大概率停止维护
📊
Issue 处理——关闭率反映维护者活跃度
👥
贡献者数量——多人参与更可持续
📖
README 质量——好项目的 README 结构清晰
⚖️
License——无协议 = 法律上不允许使用

💡 Star Lists 分类管理收藏，Awesome Lists（awesome-python 等）是社区精选资源清单

技巧

实用小技巧

⌨️ 键盘快捷键

?	查看所有快捷键
t	快速搜索文件名
.	打开在线编辑器
g+i	跳转 Issues
g+p	跳转 Pull Requests

🔗 URL 技巧

→
/compare/main...分支名 查看差异
→
替换域名为 raw.githubusercontent.com
→
commit URL + .diff 获取补丁

📝 Markdown 增强

→
任务列表 - [ ] / - [x]
→
<details> 折叠内容区域

掌握 GitHub 协作

核心功能优先级

1

仓库管理和代码浏览

每天都会用到的基础操作

2

Issue 和 Pull Request

团队协作的核心工具

3

GitHub Actions

自动化节省大量重复性工作

4

GitHub CLI + 其他

提高效率，按需学习

掌握协作流程——Issue 追踪、Branch 隔离、PR 审查、Actions 自动化——比记住每个按钮更重要

GitHub 高频功能实用指南