Git本地项目上传GitHub使用指南

1. 用户配置1.1 安装git下载地址https://git-scm.com/download/win验证安装git --version1.2 配置用户信息Git 需要知道你的身份才能提交代码配置用户名git config --global user.name 你的用户名配置邮箱邮箱使用GitHub账号关联的邮箱提交记录会显示在你的GitHub贡献图上git config --global user.email 你的邮箱example.com验证配置git config --list1.3 生成SSH密钥SSH密钥用于安全的连接GitHub避免每次都输入密码生成SSH密钥ssh-keygen -t ed25519 -C 你的邮箱example.com执行过程PS ssh-keygen -t ed25519 -C achenexample.com Generating public/private ed25519 key pair. Enter file in which to save the key (C:\Users\xxx/.ssh/id_ed25519):一直按Enter查看公钥内容cat ~/.ssh/id_ed25519.pub输出这个示例ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... achenexample.com复制上面的整个内容1.4 添加SSH到GitHub测试链接ssh -T gitgithub.com首次连接会提示The authenticity of host github.com cant be established. Are you sure you want to continue connecting (yes/no/[fingerprint])? yes输入yes并回车成功的会话显示Hi x-Achan! Youve successfully authenticated, but GitHub does not provide shell access.1.5 始化本地仓库进入项目目录后初始化Git仓库不要在已有git仓库中再执行git init会丢失远程仓库关联git init输出Initialized empty Git repository in D:/JavaProjects/.../Tankgame_v2/.git/查看状态git status会显示所有未跟踪的文件红色2.提交代码到GitHub仓库2.1 添加所有文件到暂存区git add .添加指定文件git add Main.java git add src/查看状态git status现在文件应该都是绿色的已暂存2.2 提交到本地仓库git commit -m 提交说明引号中的内容自定义2.3 重命名分支可选但推荐将本地默认分支改为 maingit branch -M main2.4 关联远程仓库添加远程仓库git remote add origin gitgithub.com:x-Achan/TankGame.git验证git remote -v输出origin gitgithub.com:x-Achan/TankGame.git (fetch) origin gitgithub.com:x-Achan/TankGame.git (push)2.5 首次推送处理远程已有文件如果 GitHub 仓库已经有文件如 README.md需要先拉取合并git pull origin main --allow-unrelated-histories如果直接覆盖原本的仓库不需要拉取pull这会打开Vim编辑器输入以下内容退出:wq2.6 推送到 GitHubgit push -u origin main-u 参数建立本地分支与远程分支的跟踪关系origin远程仓库的别名简称origin不是关键字只是一个约定俗称的名字你可以改成任意名字比如github、myrepo常用操作# 添加远程仓库别名为 origin git remote add origin gitgithub.com:x-Achan/TankGame.git # 修改远程地址 git remote set-url origin 新地址 # 删除远程仓库关联 git remote remove origin # 查看所有远程仓库 git remote -vmain 参数指定要推送的本地分支名称完整含义git push 远程仓库 本地分支查看分支# 查看本地分支 git branch * main # 查看远程分支 git branch -r origin/main # 查看所有分支 git branch -a * main remotes/origin/main首次推送可能会遇到提示The authenticity of host github.com cant be established. Are you sure you want to continue connecting (yes/no/[fingerprint])?输入yes并回车推送成功显示Enumerating objects: 98, done. Counting objects: 100% (98/98), done. ... To github.com:x-Achan/TankGame.git 968df75..9bfec58 main - main branch main set up to track origin/main.刷新GitHub网页查看上传的网页普通推送会检查远程分支是否比本地新如果远程有新的提交会拒绝推送并要求先合并不会覆盖别人的工作git push强制推送用本地分支完全覆盖远程分支覆盖远程的所有历史危险操作可能永久丢失别人的提交git push -f3. 后续更新代码3.1 日常开发流程# 1. 修改代码在你的编辑器中 # 2. 查看修改了哪些文件查看commit了那些文件 git status # 3. 添加修改到暂存区 git add . # 或者添加指定文件git add Main.java GameConfig.java # 4. 提交到本地仓库 git commit -m 描述你做了什么修改 # 示例git commit -m 修复坦克移动bug # 5. 推送到 GitHub git push因为首次推送时使用了 -u 参数以后直接 git push就行不需要再写 orgin main3.2 批量提交示例# 修改了多个文件后 git add . git commit -m v2.1 更新日志 - 新增敌方坦克AI - 优化碰撞检测 - 修复地图加载bug git push4. 版本标签管理4.1 创建版本标签当你完成一个重要版本时可以打标签标记# 创建轻量标签 git tag v1.0 # 创建带注释的标签推荐 git tag -a v1.0 -m TankGame v1.0 正式发布4.2 推送标签到GitHub# 推送单个标签 git push origin v1.0 # 推送所有标签 git push origin --tags4.3 查看标签# 查看所有标签 git tag -l # 查看特定标签信息 git show v1.04.4 切换到历史版本# 查看某个版本的代码 git checkout v1.0 # 回到主分支 git checkout main4.5 版本管理示例# 完成 v1.0 开发 git add . git commit -m 完成 v1.0 git tag -a v1.0 -m TankGame v1.0 git push origin main v1.0 # 继续开发 v2.0 # ... 编写代码 ... git add . git commit -m 完成 v2.0 新功能 git tag -a v2.0 -m TankGame v2.0 - 新增多人模式 git push origin main v2.05. 常用命令速查6. 推荐的工作流个人项目开发流程1. 创建 GitHub 仓库 ↓ 2. 本地 git init ↓ 3. 开发功能 ↓ 4. git add . git commit -m 说明 ↓ 5. 重复步骤 3-4 ↓ 6. 完成版本 → git tag -a v1.0 -m 说明 ↓ 7. git push origin main v1.0 //同时推送到main分支 和 v1.0标签 ↓ 8. 继续下一个版本...