工作目录 (Working Directory)
    ↓ git add
暂存区 (Staging Area)
    ↓ git commit
本地仓库 (Local Repository)
    ↓ git push
远程仓库 (Remote Repository)

# 仓库初始化和克隆
git init                    # 初始化本地仓库
git clone <url>            # 克隆远程仓库
git clone <url> <dirname>  # 克隆到指定目录

# 基础工作流程
git status                 # 查看文件状态
git add <file>            # 添加文件到暂存区
git add .                 # 添加所有文件
git add -A                # 添加并删除已跟踪的文件

git commit -m "message"   # 提交到本地仓库
git commit -am "message"  # 添加并提交已跟踪文件
git commit --amend        # 修改最后一次提交

# 远程操作
git remote -v             # 查看远程仓库
git remote add origin <url>  # 添加远程仓库
git push origin main      # 推送到远程分支
git pull origin main      # 拉取远程更新
git fetch origin          # 获取远程更新但不合并

# 分支基础操作
git branch                # 查看所有分支
git branch <name>         # 创建新分支
git checkout <branch>     # 切换分支
git checkout -b <branch>  # 创建并切换分支
git switch <branch>       # 新版本切换分支命令

# 分支合并和删除
git merge <branch>        # 合并分支
git branch -d <branch>    # 删除已合并分支
git branch -D <branch>    # 强制删除分支

# 远程分支操作
git push origin <branch>  # 推送分支到远程
git push -u origin <branch>  # 推送并设置跟踪
git push origin --delete <branch>  # 删除远程分支

# 查看提交历史
git log                   # 查看详细历史
git log --oneline         # 单行显示
git log --graph           # 图形化显示
git log --author="name"   # 按作者筛选
git log --since="2024-01-01"  # 按时间筛选

# 提交撤销和修改
git reset HEAD~1          # 撤销最后一次提交（保留更改）
git reset --hard HEAD~1   # 撤销最后一次提交（删除更改）
git revert <commit-hash>  # 创建反向提交
git cherry-pick <commit>  # 选择性合并提交

# 交互式变基
git rebase -i HEAD~3      # 交互式编辑最近3次提交
git rebase main           # 将当前分支变基到main

# 冲突解决流程
1. git pull origin main   # 拉取最新更新
2. # 编辑冲突文件，解决标记的冲突
3. git add <resolved-files>  # 添加解决的文件
4. git commit             # 完成合并提交

# 冲突标记解读
<<<<<<< HEAD
你的更改
=======
远程的更改
>>>>>>> branch-name

# 使用merge工具
git mergetool             # 启动可视化合并工具
git config --global merge.tool vscode  # 设置VSCode为合并工具

# GitHub Profile优化清单

## 1. 基本信息完善
- [ ] 专业头像（清晰、正式）
- [ ] 真实姓名或专业昵称
- [ ] 所在城市和时区
- [ ] 个人网站或作品集链接
- [ ] 简洁明了的Bio描述

## 2. 联系方式
- [ ] 专业邮箱地址
- [ ] LinkedIn或其他社交媒体
- [ ] 技术博客链接
- [ ] Twitter等平台账号

## 3. 技能展示
- [ ] 主要编程语言
- [ ] 专业技能领域
- [ ] 开源贡献情况
- [ ] 获得的成就和认证

# 创建特殊的Profile Repository

## 仓库名称：你的用户名
例如：如果用户名是 `johndoe`，创建名为 `johndoe` 的仓库

## README.md内容模板：

### 👋 Hi, I'm [Your Name]

- 🔭 I'm currently working on [current project]
- 🌱 I'm currently learning [learning topics]
- 👯 I'm looking to collaborate on [collaboration interests]
- 🤔 I'm looking for help with [help needed]
- 💬 Ask me about [expertise areas]
- 📫 How to reach me: [contact info]
- ⚡ Fun fact: [interesting fact about you]

### 🛠️ Technologies & Tools

![](https://img.shields.io/badge/Code-Python-informational?style=flat&logo=python&logoColor=white&color=2bbc8a)
![](https://img.shields.io/badge/Code-JavaScript-informational?style=flat&logo=javascript&logoColor=white&color=2bbc8a)
![](https://img.shields.io/badge/Tools-Docker-informational?style=flat&logo=docker&logoColor=white&color=2bbc8a)

### 📊 GitHub Stats

![Your GitHub stats](https://github-readme-stats.vercel.app/api?username=yourusername&show_icons=true&theme=radical)

![Top Languages](https://github-readme-stats.vercel.app/api/top-langs/?username=yourusername&layout=compact&theme=radical)

# 1. 生成SSH密钥
ssh-keygen -t ed25519 -C "[email protected]"
# 或使用RSA（如果系统不支持ed25519）
ssh-keygen -t rsa -b 4096 -C "[email protected]"

# 2. 启动ssh-agent
eval "$(ssh-agent -s)"

# 3. 添加密钥到ssh-agent
ssh-add ~/.ssh/id_ed25519

# 4. 复制公钥到剪贴板
# macOS:
pbcopy < ~/.ssh/id_ed25519.pub
# Linux:
xclip -sel clip < ~/.ssh/id_ed25519.pub
# Windows (Git Bash):
cat ~/.ssh/id_ed25519.pub | clip

# 5. 在GitHub设置中添加SSH密钥
# Settings → SSH and GPG keys → New SSH key

# 6. 测试SSH连接
ssh -T [email protected]

# 1. 生成GPG密钥
gpg --full-generate-key

# 2. 列出GPG密钥
gpg --list-secret-keys --keyid-format LONG

# 3. 导出公钥
gpg --armor --export YOUR_KEY_ID

# 4. 配置Git使用GPG
git config --global user.signingkey YOUR_KEY_ID
git config --global commit.gpgsign true

# 5. 在GitHub中添加GPG密钥
# Settings → SSH and GPG keys → New GPG key

# 仓库创建清单

## 1. 仓库基本信息
- [ ] 清晰描述性的仓库名称
- [ ] 简洁明了的描述
- [ ] 选择合适的开源许可证
- [ ] 创建.gitignore文件
- [ ] 初始化README.md

## 2. 项目结构规划

**README.md模板**：
```markdown
# Project Title

Brief description of what this project does and who it's for.

## 🚀 Demo

[Live Demo](https://your-demo-link.com)

![Demo Screenshot](assets/demo-screenshot.png)

## ✨ Features

- Feature 1
- Feature 2
- Feature 3

## 🛠️ Installation

```bash
# Clone the repository
git clone https://github.com/username/project-name.git

# Navigate to project directory
cd project-name

# Install dependencies
npm install

# Start the development server
npm start

// Example usage code
const example = new ExampleClass();
example.doSomething();

### Issue管理和模板

**Issue模板创建**：
```markdown
<!-- Bug Report Template -->
<!-- .github/ISSUE_TEMPLATE/bug_report.md -->

---
name: Bug Report
about: Create a report to help us improve
title: '[BUG] '
labels: bug
assignees: ''
---

## 🐛 Bug Description
A clear and concise description of what the bug is.

## 🔄 Steps to Reproduce
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

## ✅ Expected Behavior
A clear and concise description of what you expected to happen.

## 📱 Environment
- OS: [e.g. iOS, Windows, Linux]
- Browser: [e.g. chrome, safari]
- Version: [e.g. 22]

## 📷 Screenshots
If applicable, add screenshots to help explain your problem.

## ➕ Additional Context
Add any other context about the problem here.

<!-- Feature Request Template -->
<!-- .github/ISSUE_TEMPLATE/feature_request.md -->

---
name: Feature Request
about: Suggest an idea for this project
title: '[FEATURE] '
labels: enhancement
assignees: ''
---

## 🚀 Feature Description
A clear and concise description of what you want to happen.

## 💡 Motivation
Why is this feature needed? What problem does it solve?

## 📋 Detailed Description
Provide a detailed description of the feature.

## 🎨 Mockups/Examples
If applicable, add mockups or examples.

## ✅ Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2
- [ ] Criterion 3

## 🔗 Additional Context
Add any other context or screenshots about the feature request here.

# Pull Request Checklist

## 提交前检查
- [ ] 代码符合项目编码规范
- [ ] 添加了必要的测试
- [ ] 测试全部通过
- [ ] 文档已更新
- [ ] 提交信息清晰明了

## PR描述模板
### 🎯 Purpose
What is the purpose of this change?

### 📝 Changes
- Change 1
- Change 2
- Change 3

### 🧪 Testing
How has this been tested?
- [ ] Unit tests
- [ ] Integration tests
- [ ] Manual testing

### 📷 Screenshots
If applicable, include screenshots.

### 🔗 Related Issues
Fixes #123
Closes #456

# Git Flow分支模型
main/master     # 生产环境分支
develop         # 开发主分支
feature/*       # 功能开发分支
release/*       # 发布准备分支
hotfix/*        # 紧急修复分支

# GitHub Flow（简化模型）
main           # 主分支
feature/*      # 功能分支

# 分支命名规范
feature/user-authentication
bugfix/login-error-handling
hotfix/security-vulnerability
docs/api-documentation

# 新手友好项目标识

## 标签识别
- `good first issue` - 适合新手的问题
- `beginner-friendly` - 新手友好
- `help wanted` - 需要帮助
- `documentation` - 文档相关
- `easy` - 简单难度

## 项目特征
- 活跃的维护者和社区
- 清晰的贡献指南
- 详细的README和文档
- CI/CD自动化测试
- 友好的Code Review文化

## 推荐贡献类型
1. 文档改进：修正错误、补充说明
2. 测试添加：增加测试覆盖率
3. Bug修复：修复已报告的问题
4. 代码重构：改善代码质量
5. 功能开发：实现新功能

# 1. Fork项目到自己账号
# 在GitHub网页上点击Fork按钮

# 2. 克隆Fork的仓库
git clone https://github.com/your-username/project-name.git
cd project-name

# 3. 添加上游仓库
git remote add upstream https://github.com/original-owner/project-name.git

# 4. 创建功能分支
git checkout -b feature/your-feature-name

# 5. 保持分支同步
git fetch upstream
git checkout main
git merge upstream/main
git push origin main

# 开源贡献步骤

## 1. 研究阶段（30-60分钟）
- [ ] 阅读项目README和贡献指南
- [ ] 了解项目目标和架构
- [ ] 查看现有Issues和PRs
- [ ] 设置本地开发环境

## 2. 规划阶段（15-30分钟）
- [ ] 选择合适的Issue或提出新想法
- [ ] 在Issue中表达贡献意向
- [ ] 与维护者讨论实现方案
- [ ] 明确验收标准

## 3. 开发阶段（1-8小时）
- [ ] 创建功能分支
- [ ] 实现功能或修复
- [ ] 编写或更新测试
- [ ] 更新相关文档
- [ ] 本地测试验证

## 4. 提交阶段（30分钟）
- [ ] 整理提交历史
- [ ] 推送到个人Fork
- [ ] 创建Pull Request
- [ ] 填写详细的PR描述

## 5. 评审阶段（1-7天）
- [ ] 响应评审意见
- [ ] 根据反馈修改代码
- [ ] 保持积极的沟通
- [ ] 等待合并或处理拒绝

# Code Review最佳实践

## 作为提交者
- 保持开放心态接受建议
- 及时响应评审意见
- 提供清晰的解释和说明
- 学习并采纳最佳实践

## 作为审查者
- 提供建设性的反馈
- 关注代码质量和可读性
- 检查是否符合项目标准
- 认可好的设计和实现

## 常见评审要点
- 代码风格和格式
- 逻辑正确性和性能
- 安全性考虑
- 测试覆盖率
- 文档完整性

# .github/workflows/ci.yml
name: CI/CD Pipeline

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest

    strategy:
      matrix:
        node-version: [16.x, 18.x, 20.x]

    steps:
    - uses: actions/checkout@v4

    - name: Setup Node.js ${{ matrix.node-version }}
      uses: actions/setup-node@v4
      with:
        node-version: ${{ matrix.node-version }}
        cache: 'npm'

    - name: Install dependencies
      run: npm ci

    - name: Run linter
      run: npm run lint

    - name: Run tests
      run: npm test

    - name: Upload coverage reports
      uses: codecov/codecov-action@v3

  build:
    needs: test
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v4

    - name: Setup Node.js
      uses: actions/setup-node@v4
      with:
        node-version: '18'
        cache: 'npm'

    - name: Install dependencies
      run: npm ci

    - name: Build application
      run: npm run build

    - name: Upload build artifacts
      uses: actions/upload-artifact@v3
      with:
        name: build-files
        path: dist/

  deploy:
    needs: build
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'

    steps:
    - name: Deploy to production
      run: echo "Deploying to production..."

# .github/workflows/release.yml
name: Release

on:
  push:
    tags:
      - 'v*'

jobs:
  release:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v4

    - name: Create Release
      uses: actions/create-release@v1
      env:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      with:
        tag_name: ${{ github.ref }}
        release_name: Release ${{ github.ref }}
        body: |
          Changes in this Release
          - Feature 1
          - Feature 2
          - Bug fixes
        draft: false
        prerelease: false

# .github/workflows/docs.yml
name: Deploy Documentation

on:
  push:
    branches: [ main ]
    paths: [ 'docs/**' ]

jobs:
  deploy:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v4

    - name: Setup Node.js
      uses: actions/setup-node@v4
      with:
        node-version: '18'

    - name: Install dependencies
      run: npm install
      working-directory: docs

    - name: Build documentation
      run: npm run build
      working-directory: docs

    - name: Deploy to GitHub Pages
      uses: peaceiris/actions-gh-pages@v3
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: ./docs/dist

# 项目看板设置

## 列配置
1. 📋 Backlog - 待处理任务
2. 🔄 In Progress - 进行中
3. 👀 Review - 代码审查
4. ✅ Done - 已完成

## 自动化规则
- Issue创建 → 自动添加到Backlog
- PR创建 → 自动移动到Review
- PR合并 → 自动移动到Done
- Issue关闭 → 自动移动到Done

## 里程碑规划
- v1.0.0 - 基础功能实现
- v1.1.0 - 用户体验优化
- v2.0.0 - 重大功能更新

# GitHub Profile策略

## 1. 项目质量提升
- 选择3-5个最佳项目置顶
- 确保代码质量和文档完整
- 添加Live Demo和详细说明
- 展示不同技术栈的掌握

## 2. 贡献活跃度
- 保持每周至少3-5次提交
- 参与开源项目贡献
- 回答Issues和参与讨论
- 维护个人项目的更新

## 3. 技术深度展示
- 复杂项目的架构设计
- 性能优化的实际案例
- 测试覆盖率和质量保障
- 部署和运维经验

## 4. 社区参与
- Star和Fork有价值的项目
- 创建有用的工具和库
- 写技术博客和教程
- 参与开源社区讨论

# 开源项目管理

## 项目创建和维护
1. 识别痛点和需求
2. 设计简洁的解决方案
3. 编写清晰的文档
4. 建立社区规范
5. 持续维护和改进

## 社区建设
- 欢迎新贡献者
- 及时回应Issues和PRs
- 建立贡献者指南
- 组织线上/线下活动
- 建立感谢和认可机制

## 技术品牌建设
- 保持一致的代码风格
- 分享设计决策过程
- 记录技术演进历程
- 参与技术会议演讲
- 发表技术文章和观点