# 生成 SSH Key
ssh-keygen -t ed25519 -C "your-email@example.com"
 
# 查看公钥
cat ~/.ssh/id_ed25519.pub
 
# 复制公钥，粘贴到 GitHub → Settings → SSH and GPG keys → New SSH key

# 设置用户名和邮箱
git config --global user.name "Your Name"
git config --global user.email "your-email@example.com"
 
# 查看配置
git config --list

# 创建本地仓库
mkdir my-project
cd my-project
git init
 
# 创建 README
echo "# My Project" > README.md
 
# 提交
git add .
git commit -m "Initial commit"
 
# 添加远程仓库（先在 GitHub 上创建空仓库）
git remote add origin git@github.com:username/my-project.git
 
# 推送
git push -u origin main

# 安装 GitHub CLI
# macOS: brew install gh
# Windows: winget install GitHub.cli
# Linux: 包管理器安装
 
# 登录
gh auth login
 
# 创建仓库
gh repo create my-project --public --clone
 
# 创建并推送
gh repo create my-project --public --source=. --push

# HTTPS
git clone https://github.com/username/repo.git
 
# SSH
git clone git@github.com:username/repo.git
 
# GitHub CLI
gh repo clone username/repo

# 查看分支
git branch              # 本地分支
git branch -r           # 远程分支
git branch -a           # 所有分支
 
# 创建分支
git branch feature-1    # 创建
git checkout feature-1  # 切换
git checkout -b feature-1  # 创建并切换（推荐）
git switch -c feature-1    # 新语法
 
# 推送分支
git push origin feature-1
 
# 删除分支
git branch -d feature-1       # 本地
git push origin --delete feature-1  # 远程

# 查看状态
git status
 
# 添加文件
git add file.txt        # 单个文件
git add .               # 所有文件
git add -p              # 交互式添加
 
# 提交
git commit -m "feat: add new feature"
 
# 推送
git push                # 推送当前分支
git push -u origin main # 推送并设置上游

# 拉取并合并
git pull origin main
 
# 只拉取不合并
git fetch origin
 
# 变基（推荐用于保持提交历史整洁）
git pull --rebase origin main

# .gitignore 示例
 
# 依赖
node_modules/
vendor/
 
# 构建产物
dist/
build/
*.min.js
 
# 环境配置
.env
.env.local
.env.*.local
 
# IDE
.idea/
.vscode/
*.swp
*.swo
 
# 系统文件
.DS_Store
Thumbs.db
 
# 日志
*.log
logs/
 
# 临时文件
*.tmp
*.temp
.cache/

# 使用 GitHub CLI
gh issue create --title "Bug: 登录页面样式错乱" --body "描述内容..."
 
# 交互式创建
gh issue create -w

<!-- .github/ISSUE_TEMPLATE/bug_report.md -->
---
name: Bug 报告
about: 报告一个 Bug
title: '[Bug] '
labels: bug
assignees: ''
---
 
## Bug 描述
清晰地描述这个 Bug 是什么。
 
## 复现步骤
1. 进入 '...'
2. 点击 '...'
3. 看到 '...'
 
## 预期行为
描述你期望发生什么。
 
## 实际行为
描述实际发生了什么。
 
## 截图
如果适用，添加截图帮助解释问题。
 
## 环境信息
- OS: [如 macOS, Windows, Linux]
- Browser: [如 Chrome, Safari, Firefox]
- Version: [如 1.0.0]
 
## 其他信息
其他任何有助于解决问题的信息。

<!-- .github/ISSUE_TEMPLATE/feature_request.md -->
---
name: 功能请求
about: 提出一个新功能建议
title: '[Feature] '
labels: enhancement
assignees: ''
---
 
## 功能描述
清晰地描述你想要的功能。
 
## 问题背景
这个功能解决了什么问题？
 
## 建议方案
你希望如何实现这个功能？
 
## 替代方案
你考虑过的其他替代方案。
 
## 附加信息
任何其他相关信息或截图。

# GitHub CLI
gh label create "bug" --color "d73a4a" --description "Something isn't working"

[Bug] 登录页面在移动端样式错乱
[Feature] 添加暗黑模式支持
[Docs] 更新 API 文档
[Refactor] 重构用户模块
[Performance] 优化首页加载速度

## 问题描述
简洁描述问题是什么。
 
## 复现步骤
1. 步骤一
2. 步骤二
3. 步骤三
 
## 期望结果
应该如何表现。
 
## 实际结果
实际如何表现。
 
## 环境信息
- 操作系统：
- 浏览器：
- 版本：
 
## 相关信息
- 相关 Issue: #123
- 相关 PR: #456

# 合并 PR 时自动关闭
git commit -m "fix: 修复登录问题，关闭 #123"
 
# 关键词
fixes #123
closes #123
resolves #123
 
# 多个 Issue
fixes #123, fixes #456

# .github/workflows/label.yml
name: Auto Label
on:
  issues:
    types: [opened]
 
jobs:
  label:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/github-script@v7
        with:
          script: |
            const issue = context.payload.issue;
            const labels = [];
            
            if (issue.title.includes('[Bug]')) {
              labels.push('bug');
            }
            if (issue.title.includes('[Feature]')) {
              labels.push('enhancement');
            }
            
            if (labels.length > 0) {
              await github.rest.issues.addLabels({
                owner: context.repo.owner,
                repo: context.repo.repo,
                issue_number: issue.number,
                labels: labels
              });
            }

# 1. Fork 仓库（如果是别人的项目）
# 在 GitHub 页面点击 Fork
 
# 2. 克隆到本地
git clone git@github.com:your-username/repo.git
 
# 3. 创建分支
git checkout -b feature/add-login
 
# 4. 修改代码
# ... 编辑文件 ...
 
# 5. 提交
git add .
git commit -m "feat: add login page"
 
# 6. 推送分支
git push origin feature/add-login
 
# 7. 在 GitHub 页面创建 PR
# 或使用 CLI
gh pr create --title "feat: add login page" --body "描述..."

# 交互式创建
gh pr create
 
# 完整参数
gh pr create \
  --title "feat: add login page" \
  --body "详见下方描述" \
  --base main \
  --head feature/add-login \
  --reviewer username1,username2 \
  --assignee @me \
  --label enhancement
 
# 从模板创建
gh pr create --template

## 变更类型
- [ ] Bug 修复
- [ ] 新功能
- [ ] 重构
- [ ] 文档更新
- [ ] 性能优化
 
## 变更描述
简洁描述这个 PR 做了什么。
 
## 相关 Issue
关闭 #123
 
## 变更内容
- 添加了登录页面
- 实现了表单验证
- 添加了单元测试
 
## 测试
- [ ] 本地测试通过
- [ ] 单元测试通过
- [ ] E2E 测试通过
 
## 截图
如果有 UI 变更，添加截图。
 
## Checklist
- [ ] 代码遵循项目规范
- [ ] 已添加必要的注释
- [ ] 已更新相关文档
- [ ] 已添加测试用例

# 好的审查评论
 
## 建议改进
```suggestion
const result = data.filter(item => item.active);

 
### 4.5 PR 合并策略
 
**Merge（普通合并）：**
 
```bash
# 在 GitHub 页面点击 "Merge pull request"
# 会创建一个 merge commit

# 把所有 commit 压缩成一个
# 保持主分支历史整洁

# 变基后合并，不产生 merge commit
# 保持线性历史

# 普通 merge
git checkout main
git merge feature/add-login
 
# Squash merge
git merge --squash feature/add-login
git commit -m "feat: add login page"
 
# Rebase
git checkout feature/add-login
git rebase main
git checkout main
git merge feature/add-login

feat: 添加用户登录功能
fix: 修复登录页面样式问题
docs: 更新 API 文档
refactor: 重构用户模块
test: 添加登录功能测试
chore: 更新依赖版本

feat: 新功能
fix: Bug 修复
docs: 文档变更
style: 代码格式（不影响逻辑）
refactor: 重构
perf: 性能优化
test: 测试
chore: 构建/工具变更
ci: CI 配置变更

# .github/workflows/ci.yml
name: CI                    # 工作流名称
 
on:                         # 触发条件
  push:                     # 推送时触发
    branches: [main]        # 指定分支
  pull_request:             # PR 时触发
    branches: [main]
 
jobs:                       # 任务列表
  test:                     # 任务名称
    runs-on: ubuntu-latest  # 运行环境
    
    steps:                  # 步骤列表
      - name: Checkout      # 步骤名称
        uses: actions/checkout@v4  # 使用 action
        
      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          
      - name: Install
        run: npm ci
        
      - name: Test
        run: npm test

on:
  # 推送时触发
  push:
    branches: [main, develop]
    paths:
      - 'src/**'            # 只有 src 目录变更才触发
      - 'package.json'
  
  # PR 时触发
  pull_request:
    branches: [main]
  
  # 定时触发
  schedule:
    - cron: '0 0 * * *'     # 每天 0 点
  
  # 手动触发
  workflow_dispatch:
    inputs:
      environment:
        description: 'Deploy environment'
        required: true
        default: 'staging'
  
  # 其他工作流完成后触发
  workflow_run:
    workflows: ["CI"]
    types: [completed]

# .github/workflows/ci.yml
name: CI/CD
 
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
 
jobs:
  test:
    runs-on: ubuntu-latest
    
    strategy:
      matrix:
        node-version: [18, 20, 22]
    
    steps:
      - uses: actions/checkout@v4
      
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
          cache: 'npm'
      
      - run: npm ci
      - run: npm run lint
      - run: npm test
      - run: npm run build
      
      - name: Upload coverage
        uses: codecov/codecov-action@v4
        with:
          token: ${{ secrets.CODECOV_TOKEN }}
 
  deploy:
    needs: test
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'
    
    steps:
      - uses: actions/checkout@v4
      
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      
      - run: npm ci
      - run: npm run build
      
      - name: Deploy to Vercel
        uses: amondnet/vercel-action@v25
        with:
          vercel-token: ${{ secrets.VERCEL_TOKEN }}
          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}

# .github/workflows/publish.yml
name: Publish to npm
 
on:
  release:
    types: [created]
 
jobs:
  publish:
    runs-on: ubuntu-latest
    
    steps:
      - uses: actions/checkout@v4
      
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          registry-url: 'https://registry.npmjs.org'
      
      - run: npm ci
      - run: npm run build
      - run: npm test
      
      - run: npm publish
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

# .github/workflows/release.yml
name: Release
 
on:
  push:
    branches: [main]
 
jobs:
  release:
    runs-on: ubuntu-latest
    if: "!contains(github.event.head_commit.message, 'ci skip')"
    
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
          
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          
      - run: npm ci
      
      - name: Release
        run: npx semantic-release
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

steps:
  - name: Deploy
    run: |
      curl -X POST \
        -H "Authorization: Bearer ${{ secrets.DEPLOY_TOKEN }}" \
        https://api.example.com/deploy

# .github/workflows/pages.yml
name: Deploy to Pages
 
on:
  push:
    branches: [main]
 
permissions:
  contents: read
  pages: write
  id-token: write
 
jobs:
  deploy:
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    
    steps:
      - uses: actions/checkout@v4
      
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          
      - run: npm ci
      - run: npm run build
      
      - uses: actions/configure-pages@v4
      - uses: actions/upload-pages-artifact@v3
        with:
          path: './dist'
          
      - id: deployment
        uses: actions/deploy-pages@v4

https://username.github.io/repo-name/

// package.json
{
  "name": "@username/package-name",
  "publishConfig": {
    "registry": "https://npm.pkg.github.com"
  }
}

# 认证
npm login --scope=@username --registry=https://npm.pkg.github.com
 
# 发布
npm publish

# .npmrc
@username:registry=https://npm.pkg.github.com

npm install @username/package-name

# 安装 VS Code 插件
# 或使用 GitHub CLI
gh copilot explain "这段代码做了什么"
gh copilot suggest "写一个排序函数"

# 搜索代码
filename:package.json lodash
 
# 搜索仓库
stars:>1000 language:JavaScript
 
# 搜索 Issue
is:issue is:open label:bug
 
# 搜索 PR
is:pr is:merged author:username
 
# 组合搜索
repo:facebook/react is:issue is:open comments:>10

# 1. Fork 项目
# 在 GitHub 页面点击 Fork
 
# 2. 克隆 Fork 的仓库
git clone git@github.com:your-username/project.git
cd project
 
# 3. 添加上游仓库
git remote add upstream git@github.com:original-owner/project.git
 
# 4. 同步上游代码
git fetch upstream
git checkout main
git merge upstream/main
 
# 5. 创建功能分支
git checkout -b fix/issue-123
 
# 6. 修改代码
# ... 编辑文件 ...
 
# 7. 提交
git add .
git commit -m "fix: 解决问题 #123"
 
# 8. 推送到 Fork
git push origin fix/issue-123
 
# 9. 创建 PR
gh pr create --title "fix: 解决问题" --body "关闭 #123"
 
# 10. 保持分支更新
git fetch upstream
git rebase upstream/main
git push origin fix/issue-123 --force

main (生产分支)
  └── develop (开发分支)
        ├── feature/xxx (功能分支)
        ├── feature/yyy
        └── release/1.0.0 (发布分支)
              └── hotfix/xxx (紧急修复)

main (主分支)
  ├── feature/xxx
  └── fix/yyy

# 1. 从 main 创建功能分支
git checkout main
git pull
git checkout -b feature/user-auth
 
# 2. 开发并提交
git add .
git commit -m "feat: add user auth"
git push origin feature/user-auth
 
# 3. 创建 PR
gh pr create
 
# 4. Code Review
# 在 GitHub 页面审查
 
# 5. 合并
# Squash and merge
 
# 6. 删除分支
git branch -d feature/user-auth
git push origin --delete feature/user-auth

# 查看仓库信息
gh repo view
 
# 查看我的 PR
gh pr list --author @me
 
# 查看需要审查的 PR
gh pr list --search "review-requested:@me"
 
# 查看某个 PR 详情
gh pr view 123
 
# 检出 PR 到本地
gh pr checkout 123
 
# 在浏览器打开
gh pr view 123 --web
 
# 快速添加评论
gh pr comment 123 --body "LGTM!"
 
# 批准 PR
gh pr review 123 --approve --body "Nice work!"
 
# 合并 PR
gh pr merge 123 --squash
 
# 查看 Issue
gh issue list --label bug
 
# 创建 Issue
gh issue create --title "Bug" --body "描述"
 
# 关闭 Issue
gh issue close 123
 
# 查看 Actions 运行状态
gh run list
gh run view
 
# 监听运行日志
gh run watch
 
# 查看工作流
gh workflow list
gh workflow view ci.yml
 
# 手动触发工作流
gh workflow run ci.yml

# .github/workflows/release.yml
name: Release
 
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
 
jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
          token: ${{ secrets.GITHUB_TOKEN }}
          
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          
      - run: npm ci
      - run: npm run build
      - run: npm test
      
      - name: Release
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
        run: npx semantic-release

{
  "name": "my-package",
  "version": "0.0.0-development",
  "scripts": {
    "semantic-release": "semantic-release"
  },
  "repository": {
    "type": "git",
    "url": "https://github.com/username/my-package.git"
  }
}

# 方法一：revert（推荐，安全）
git revert <commit-hash>
git push
 
# 方法二：reset（危险，会丢失提交）
git reset --hard <commit-hash>
git push --force
 
# 方法三：交互式 rebase
git rebase -i HEAD~3
# 把要删除的 commit 标记为 drop
git push --force

# 1. 拉取最新代码
git fetch origin
git merge origin/main
 
# 2. 查看冲突文件
git status
 
# 3. 手动解决冲突
# 打开冲突文件，找到 <<<<<<< HEAD 标记
# 选择要保留的代码，删除冲突标记
 
# 4. 标记为已解决
git add <resolved-file>
 
# 5. 完成合并
git commit
# 或继续 rebase
git rebase --continue

<<<<<<< HEAD
const name = 'current';  // 当前分支的代码
=======
const name = 'incoming'; // 要合并进来的代码
>>>>>>> feature-branch

# 修改最近一次 commit
git commit --amend -m "新的提交信息"
git push --force
 
# 修改历史 commit（交互式 rebase）
git rebase -i HEAD~3
# 把 pick 改为 reword
# 保存后会打开编辑器修改信息
git push --force

# 查找已删除分支的 commit
git reflog
 
# 找到分支删除前的 commit hash
# 恢复分支
git checkout -b <branch-name> <commit-hash>
 
# 或者使用 GitHub CLI
gh api repos/{owner}/{repo}/branches/{branch}

# 删除本地已合并的分支
git branch --merged main | grep -v "^\*\|main" | xargs git branch -d
 
# 删除远程已合并的分支
git branch -r --merged origin/main | grep -v "main" | sed 's/origin\//:/' | xargs git push
 
# 使用 GitHub CLI
gh pr list --state merged --json headRefName --jq '.[].headRefName' | \
  xargs -I {} git push origin --delete {}

# 使用 Git LFS
git lfs install
git lfs track "*.psd"
git lfs track "*.mp4"
git add .gitattributes
git commit -m "chore: setup git lfs"
git push

# 重命名分支
git branch -m main new-default
git push origin -u new-default
git push origin --delete main
 
# 然后在 GitHub 设置中更改默认分支

# 从暂存区移除
git reset HEAD <file>
 
# 从历史中移除
git filter-branch --force --index-filter \
  "git rm --cached --ignore-unmatch path/to/sensitive-file" \
  --prune-empty --tag-name-filter cat -- --all

# 安装 BFG
brew install bfg
 
# 删除敏感文件
bfg --delete-files sensitive-file.txt
git reflog expire --expire=now --all
git gc --prune=now --aggressive
git push --force