前提条件
-
已经在 GitHub 网页上创建好了空仓库 (不要勾选
Add a README,保持完全空白)。 -
复制好仓库的 HTTPS 地址 (格式:
https://github.com/你的用户名/仓库名.git)。切记 :直接用 HTTPS,不要再碰 SSH(除非你专门配置过密钥),这样能避开
Permission denied的坑。


操作步骤(共 6 步)
在项目文件夹中打开命令行(Git Bash 或 CMD),按顺序执行:
第 1 步:初始化本地仓库
git init
第 2 步:配置你的身份(避免提交作者显示为 unknown)
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"
第 3 步:添加所有文件到暂存区
git add .
(如果只想提交部分文件,可以将 . 换成具体文件名)
第 4 步:提交到本地仓库(生成版本记录)
git commit -m "首次提交代码备份"
第 5 步:关联远程 GitHub 仓库(使用 HTTPS)
git remote add origin https://github.com/你的用户名/你的
通常新建的项目下面有:

第 6 步:推送并建立关联(浏览器会弹出授权窗口)
git branch -M main
git push -u origin main
上面的截图中有
完整命令汇总(直接复制替换即可)
假设你的新项目叫 new_project,用户名是 testdemo_nocode,那么完整命令如下:
git init
git config --global user.name "qiuxiaqing"
git config --global user.email "你的邮箱@qq.com"
git add .
git commit -m "首次提交代码备份"
git remote add origin git@github.com:qiuxiaqing/testdemo_nocode.git
git branch -M main
git push -u origin main
其实如果登录好了也就是前面有:git init、git add. 、以及git commit -m "备注",后面的3条github上有操作
后续日常提交(仅需 3 步)
git add .
git commit -m "描述你改了什么"
git push
关键避坑指南(必看)
| 常见错误 | 原因 | 正确做法 |
|---|---|---|
fatal: not a git repository |
忘记 git init |
先 git init,再执行其他操作 |
Permission denied (publickey) |
用了 SSH 地址但没配密钥 | 改用 HTTPS 地址(https://github.com/...) |
Committer: unknown |
没有配置全局 user.name 和 user.email |
先执行 git config --global user.name/email |
LF will be replaced by CRLF |
Windows 换行符转换提醒 | 直接忽略,不影响代码 |
进阶建议:忽略不必要的文件
你这次上传了 __pycache__/ 文件夹(编译缓存),这些文件其实没必要备份到 GitHub。下次新项目开始前,可以在项目根目录新建一个 .gitignore 文件,内容如下:
__pycache__/
*.pyc
*.pth
*.pt
runs/
然后在执行 git add . 之前保存这个文件,Git 就会自动跳过这些大文件和缓存文件,让仓库更轻量。