从零开始管理你的代码仓库
一、基础准备（10分钟）
1. 注册GitHub账号
- 访问GitHub官网，点击右上角Sign up
- 填写邮箱、用户名和密码（建议使用强密码）
- 完成人机验证后，进入邮箱点击验证链接激活账号
2. 安装Git客户端
Windows：下载Git for Windows
macOS：通过Homebrew安装：brew install git
Linux：使用包管理工具：sudo apt-get install git
安装完成后，打开命令行工具（Windows用Git Bash，macOS/Linux用终端），配置个人信息：
1
2git config --global user.name "你的GitHub用户名"
git config --global user.email "你的注册邮箱"验证配置：git config –list
3. 安装GitHub Desktop（可选）
- 下载地址：GitHub Desktop
- 适合不熟悉命令行的用户，通过图形界面完成代码提交、分支管理等操作
二、创建第一个项目（20分钟）
1. 在GitHub创建远程仓库
- 登录后点击右上角+ → New repository
- 填写仓库信息：
- Repository name：建议与项目名称一致（如my-first-project）
- Description：简要描述项目用途
- Visibility：选择Public（公开免费）
- 勾选Add a README file（自动生成项目说明文件）
- 点击Create repository完成创建
2. 克隆仓库到本地
打开命令行，执行克隆命令（替换为你的仓库URL）：
1
git clone https://github.com/你的用户名/my-first-project.git
进入项目目录：cd my-first-project
3. 添加并提交代码
创建一个测试文件（如index.html）：
1
2<h1>Hello, GitHub!</h1>
<p>这是我的第一个GitHub项目</p>将文件添加到暂存区：
1
git add index.html
提交更改并添加描述：
1
git commit -m "Add initial HTML file"
（-m参数用于添加提交说明，建议清晰描述改动内容）
4. 推送代码到GitHub
关联远程仓库（通常克隆时已自动关联）：
1
git remote add origin https://github.com/你的用户名/my-first-project.git
推送代码到主分支：
1
git push -u origin main
（首次推送需输入GitHub账号密码，后续可配置SSH密钥免密登录）
三、关键操作与工具（30分钟）
1. 使用SSH密钥免密登录
生成SSH密钥（在命令行执行）：
1
ssh-keygen -t rsa -b 4096 -C "你的邮箱"
按回车键使用默认路径和空密码
复制公钥内容：
1
2
3
4
5
6# Windows
clip < ~/.ssh/id_rsa.pub
# macOS
pbcopy < ~/.ssh/id_rsa.pub
# Linux
cat ~/.ssh/id_rsa.pub登录GitHub → Settings → SSH and GPG keys → New SSH key，粘贴公钥并保存
2. 使用GitHub Desktop简化操作
- 克隆仓库：点击File → Clone repository，选择远程仓库并指定本地路径
- 提交代码：直接在界面修改文件后，填写提交信息并点击Commit to main
- 推送代码：点击Push origin完成同步
3. 版本回退与冲突解决
撤销未提交的更改：
1
2git checkout -- 文件名 # 撤销单个文件
git checkout . # 撤销所有未提交更改回退到历史版本：
1
2git log --oneline # 查看提交历史
git reset --hard 提交哈希值 # 回退到指定版本（谨慎操作！）解决合并冲突：
当多人修改同一文件时，拉取代码可能出现冲突。在文件中找到冲突标记（<<<<<<< ======= >>>>>>>），手动编辑后保存，重新提交
四、项目维护与协作（40分钟）
1. 使用Issues管理任务
- 在仓库页面点击Issues → New issue
- 填写标题和描述，可添加标签（Labels）、指派负责人（Assignees）
- 完成后点击Submit new issue，任务状态会自动跟踪
2. 创建分支进行开发
创建并切换分支：
1
2git branch feature/new-page # 创建分支
git checkout feature/new-page # 切换分支或一步完成：git checkout -b feature/new-page
合并分支到主分支：
1
2git checkout main # 切换回主分支
git merge feature/new-page # 合并分支删除分支：
1
2git branch -d feature/new-page # 删除本地分支
git push origin --delete feature/new-page # 删除远程分支
3. 发起Pull Request进行代码审查
推送分支到远程：
1
git push origin feature/new-page
进入GitHub仓库页面，点击Compare & pull request
填写说明并选择审查人，点击Create pull request
审查通过后，点击Merge pull request合并代码
五、进阶功能（可选）
1. 部署静态网站（GitHub Pages）
- 创建仓库命名为你的用户名.github.io
- 推送HTML/CSS/JS文件到主分支
- 访问https://你的用户名.github.io即可查看网站
2. 使用Actions自动化流程
在仓库根目录创建.github/workflows目录
添加ci.yml文件，定义自动化任务（如代码测试、部署）：
1
2
3
4
5
6
7
8
9name: CI
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Run tests
run: npm install && npm test提交文件后，GitHub会自动触发工作流
六、学习资源推荐
- 官方文档：
- GitHub学习中心：包含互动教程和分步指南
- Git官方文档：深入理解版本控制原理
- 视频教程：
- GitHub官方YouTube频道：5分钟快速教程
- FreeCodeCamp Git教程：适合初学者的免费课程
- 书籍推荐：
- 《Pro Git》：免费在线版(链接)，Git权威指南
- 《GitHub入门与实践》：结合实际案例讲解协作开发
七、常见问题解决
- 推送代码失败：
- 提示Permission denied：检查SSH密钥是否正确配置
- 提示Updates were rejected：先拉取远程最新代码：git pull –rebase origin main
- 忘记Git命令：
- 使用git help <命令>查看帮助，如git help commit
- 安装git-extras插件，提供更友好的提示：brew install git-extras（macOS）
- 文件未被Git跟踪：
- 检查是否在.gitignore中被排除，编辑该文件并重新提交
通过以上步骤，你可以在1小时内完成从注册到发布项目的全流程，并掌握基础的版本控制和协作技能。建议从简单项目开始实践，逐步探索GitHub的强大功能。遇到问题时，GitHub社区和文档是最好的帮手！ 🚀