Skip to content

SETUP_GITHUB.md

Latest commit

 

History

History
225 lines (170 loc) · 4.46 KB

SETUP_GITHUB.md

File metadata and controls

225 lines (170 loc) · 4.46 KB

GitHub配置指南 - SSH版

📋 当前状态

✅ SSH密钥已配置完成！

你已经成功配置了SSH密钥，可以无需密码/Token推送代码到GitHub。

🔐 SSH配置验证

检查SSH状态

# 测试SSH连接
ssh -T git@github.com

# 应该看到:
# Hi tuobi2! You've successfully authenticated, but GitHub does not provide shell access.

SSH密钥位置

# 查看SSH密钥
ls -la ~/.ssh/

# 应该看到:
# id_ed25519      # 私钥 (不要分享!)
# id_ed25519.pub  # 公钥 (已添加到GitHub)

🚀 推送方式

方法1: 直接使用git命令（推荐）

cd /Users/lijiepeng/python3
git push origin main

方法2: 使用SSH推送脚本

cd /Users/lijiepeng/python3
./push_ssh.sh

方法3: 使用完整推送脚本

cd /Users/lijiepeng/python3
./push_to_github.sh

🔧 Git配置

查看当前配置

git config --list | grep -E "(user\.|remote\.|core\.)"

你的配置

user.name=lijiepeng
user.email=155253629@qq.com
remote.origin.url=git@github.com:tuobi2/python3-learning.git

如果需要修改配置

# 设置用户名
git config --global user.name "你的名字"

# 设置邮箱
git config --global user.email "你的邮箱"

# 设置默认编辑器
git config --global core.editor "vim"

# 设置自动换行
git config --global core.autocrlf input

📁 项目推送状态

当前仓库

  • 远程仓库: git@github.com:tuobi2/python3-learning.git
  • 本地分支: main
  • 认证方式: SSH密钥

推送测试

# 测试推送
cd /Users/lijiepeng/python3
git push --dry-run origin main

# 实际推送
git push origin main

🔄 工作流程

日常开发流程

# 1. 拉取最新代码
git pull origin main

# 2. 创建新分支
git checkout -b feature/new-feature

# 3. 开发代码
# ... 编写代码 ...

# 4. 提交更改
git add .
git commit -m "添加新功能"

# 5. 推送到GitHub
git push origin feature/new-feature

# 6. 创建Pull Request
# 在GitHub网站上操作

🛠️ 故障排除

SSH连接问题

# 1. 检查SSH代理
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# 2. 测试连接
ssh -T git@github.com

# 3. 检查GitHub公钥
# 访问: https://github.com/settings/keys

Git推送问题

# 1. 检查远程仓库
git remote -v

# 2. 检查分支
git branch -a

# 3. 拉取最新代码
git pull origin main --rebase

# 4. 强制推送（谨慎使用）
git push -f origin main

权限问题

# 检查文件权限
ls -la ~/.ssh/

# 修复权限
chmod 600 ~/.ssh/id_ed25519
chmod 644 ~/.ssh/id_ed25519.pub

📚 学习资源

Git学习

SSH配置

GitHub使用

🎯 最佳实践

提交规范

# 使用约定式提交
git commit -m "feat: 添加新功能"
git commit -m "fix: 修复bug"
git commit -m "docs: 更新文档"
git commit -m "style: 代码格式"
git commit -m "refactor: 代码重构"
git commit -m "test: 添加测试"
git commit -m "chore: 构建过程"

分支管理

  • main - 主分支，稳定版本
  • develop - 开发分支
  • feature/* - 功能分支
  • bugfix/* - 修复分支
  • release/* - 发布分支

代码审查

  1. 创建Pull Request
  2. 请求代码审查
  3. 通过CI/CD检查
  4. 合并到主分支

🔒 安全注意事项

保护SSH密钥

  • ✅ 私钥 (id_ed25519) 不要分享给任何人
  • ✅ 公钥 (id_ed25519.pub) 可以添加到GitHub
  • ✅ 使用强密码保护私钥
  • ✅ 定期更新密钥

📞 帮助支持

遇到问题？

  1. 检查本指南的相关章节
  2. 查看GitHub官方文档
  3. 搜索Stack Overflow
  4. 在GitHub Issues中提问

联系方式

现在你可以轻松地使用SSH推送代码到GitHub！ 🚀