插件窝 干货文章 实践操作:github使用记录

实践操作:github使用记录

Git GitHub 分支 bash 928    来源:    2025-05-10

以下是一份详细的GitHub使用实践指南,涵盖从基础到进阶的常用操作,帮助您高效管理代码和协作开发:


一、GitHub基础配置

  1. 注册与SSH配置

    # 生成SSH密钥(本地操作)
    ssh-keygen -t ed25519 -C "your_email@example.com"
    # 将公钥添加到GitHub
    cat ~/.ssh/id_ed25519.pub
    
    • 复制输出内容 → GitHub Settings → SSH and GPG keys → New SSH key
  2. 全局Git配置

    git config --global user.name "YourName"
    git config --global user.email "your_email@example.com"
    git config --global core.editor "code --wait"  # 使用VSCode作为默认编辑器
    

二、仓库基础操作

1. 本地项目关联GitHub

bash git init git add . git commit -m "Initial commit" git remote add origin git@github.com:username/repo.git git push -u origin main

2. 克隆仓库

bash git clone git@github.com:username/repo.git # 或克隆指定分支 git clone -b branch_name git@github.com:username/repo.git

3. 分支管理

bash git branch # 查看分支 git checkout -b feature-branch # 创建并切换分支 git push origin feature-branch # 推送新分支到远程 git merge feature-branch # 合并分支(需先切到main分支)


三、协作开发流程

1. Fork + Pull Request

  • 在GitHub页面点击Fork → 克隆自己的fork仓库 bash git remote add upstream git@github.com:original_owner/repo.git # 添加源仓库 git fetch upstream # 同步源仓库变更

2. 处理冲突

bash git pull origin main # 拉取最新代码 # 手动解决冲突后 git add . git commit -m "Resolve conflicts" git push

3. Code Review

  • 在Pull Request页面:
    • 点击"Files changed"查看代码差异
    • 使用行内评论功能提出建议
    • 通过"Review changes"提交正式评审

四、高效使用GitHub功能

1. Issues管理

  • 模板:创建.github/ISSUE_TEMPLATE.md
  • 关联PR:在commit消息中添加Fix #123(自动关闭Issue)

2. GitHub Actions自动化

yaml # .github/workflows/ci.yml 示例 name: CI on: [push] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - run: npm install && npm test

3. Projects看板

  • 将Issues/PRs拖拽到"To Do"、"In Progress"、"Done"列

五、高级技巧

  1. Git别名提高效率

    git config --global alias.co checkout
    git config --global alias.br branch
    git config --global alias.st status
    
  2. GitHub CLI工具

    gh repo clone username/repo      # 免SSH配置克隆
    gh pr create --web              # 通过浏览器创建PR
    gh issue list                   # 查看Issues
    
  3. 大文件存储(Git LFS)

    git lfs install
    git lfs track "*.psd"
    git add .gitattributes
    

六、常见问题解决

  1. 撤销错误提交

    git reset --soft HEAD~1         # 保留更改
    git reset --hard HEAD~1         # 丢弃更改
    
  2. 恢复误删分支

    git checkout -b branch_name SHA  # 通过commit哈希恢复
    
  3. 403权限错误

    • 检查SSH配置
    • 更新远程URL:git remote set-url origin git@github.com:user/repo.git

七、安全最佳实践

  1. 使用Personal Access Token替代密码
  2. 定期检查仓库的Security Alerts
  3. 敏感信息使用.gitignore过滤或GitHub Secrets存储

通过以上流程,您可以系统性地使用GitHub进行版本控制和团队协作。建议结合图形化工具(如GitHub Desktop/VSCode的Git插件)提升操作直观性。