手把手教你把本地代码推送到GitCode（超详细小白教程）
前言：写了好多代码都存在电脑里，怕丢了想备份？想给别人展示自己的项目？想把代码放到云端随时下载？这篇教程就是为你准备的！不用懂太多原理，跟着步骤做就行。
本文适合谁看？
- ✅ 电脑里存了一些代码项目，想备份到网上
- ✅ 听说过GitHub/GitCode，但不知道咋用
- ✅ 完全零基础，只想快速把代码传上去
- ❌ 不想看复杂原理，只想跟着步骤做
准备工作（只需做一次）
1. 安装Git（代码管理工具）
打开浏览器，访问：https://git-scm.com/download/win
下载后一路点击"下一步"安装即可，全部保持默认设置。
验证是否安装成功：按 Win + R，输入 cmd 回车，在黑色窗口里输入：
git --version看到版本号（如 git version 2.40.0）就是成功了！
2. 注册GitCode账号
打开 https://gitcode.com，用ZEEKLOG账号直接登录，或者手机号注册。
正式开始：本地项目→GitCode
假设你的项目在 D:\Desktop\my-project 文件夹里，里面是你写好的代码。
第一步：打开命令行，进入项目文件夹
按 Win + R，输入 cmd 回车，输入：
cd D:\Desktop\my-project小贴士：cd就是进入文件夹的命令。如果不确定路径，可以打开文件夹，在地址栏输入cmd直接打开命令行。
第二步：初始化本地仓库
在刚才的命令行里输入：
git init会看到提示：Initialized empty Git repository ...，表示成功！
第三步：把文件添加到仓库
输入：
git add . 注意：. 表示当前文件夹的所有文件，别漏了！第四步：给这次提交写个备注
输入：
git commit -m "第一次提交，上传项目"引号里可以写任意描述，比如"修复了bug"、"添加新功能"等。
在GitCode上创建"空房子"
现在要在GitCode上创建一个空仓库，用来存放你的代码。
1. 登录GitCode，新建项目
- 打开 https://gitcode.com 并登录
- 点击右上角 "+" 号 → "新建项目"
2. 填写项目信息
| 填写项 | 说明 |
|---|---|
| 项目名称 | 英文最好，比如 my-project |
| 项目描述 | 简单写一下这个项目是干嘛的 |
| 可见性 | 公开（别人能看到）/私有（只有自己能看到） |
3. 关键：创建空仓库
这一行很重要！看到下面的勾选项：
- [ ] 使用README文件初始化仓库 ← 不要勾！
- [ ] 添加.gitignore文件 ← 不要勾！
- [ ] 添加开源许可证 ← 不要勾！
全部留空！ 因为我们要推送已有代码，勾选了会冲突。
点击 "创建项目"。
4. 复制仓库地址
创建成功后，看到页面中间有个链接，复制下来：
https://gitcode.com/你的用户名/my-project.git
本地与云端"连线"
回到命令行（确保还在项目文件夹里），输入：
git remote add origin https://gitcode.com/你的用户名/my-project.git验证是否成功：
git remote -v看到两行地址就是成功了！
推送代码到GitCode
第一步：统一分支名称
输入：
git branch -M main第二步：推送！
输入：
git push -u origin main这时候会弹窗让你输入账号密码：
| 输入项 | 写什么 |
|---|---|
| 用户名 | 你的GitCode账号（手机号、邮箱、或@前面的名字） |
| 密码 | 注意！这里不是登录密码！ |
第三步：获取个人访问令牌（PAT）
GitCode为了安全，不允许直接用密码推送，需要申请"令牌"：
- 打开 https://gitcode.com，登录
- 点击右上角 头像 → "个人设置"
- 左侧菜单找到 "访问令牌"（Personal Access Tokens）
- 点击 "新建访问令牌"
- 填写名称（如"我的电脑"），勾选 "项目（读写）" 权限
- 点击生成，立即复制（只显示一次！）
把这个令牌粘贴到刚才密码框里，就成功了！
验证是否成功
刷新GitCode页面，如果看到你的代码文件，恭喜你，上传成功！🎉
以后修改代码后，只需要三行命令就能更新：
git add . git commit -m "描述这次修改" git push常见问题急救包
问题1：提示 "Authentication failed"（认证失败）
原因：密码输入错误，或者用了登录密码而不是令牌。
解决：重新执行 git push，用户名填GitCode账号，密码必须填PAT令牌。
问题2：提示 "Push rejected"（推送被拒绝）
原因：创建仓库时勾选了README或其他初始化文件，导致远程不是空的。
解决：
- 简单方法：删除这个仓库，重新创建，记得不要勾选任何东西
- 或者执行：
git pull origin main --allow-unrelated-histories先合并
问题3：提示 "File too large"（文件太大）
原因：项目里有超过100MB的文件（比如视频、exe程序）。
解决：在项目根目录创建 .gitignore 文件，写入：
node_modules/ dist/ *.exe *.mp4然后重新 git add .、git commit、git push。
问题4：每次都要输入账号密码
解决：配置自动记住密码（任选一种）：
# Windows推荐 git config --global credential.helper manager-core # 或者把令牌直接写进地址（替换"你的令牌"） git remote set-url origin https://你的令牌@gitcode.com/用户名/项目.git总结：只需记住这几步
# 第一次上传 cd 项目文件夹 git init git add . git commit -m "备注" git remote add origin https://gitcode.com/用户名/项目.git git branch -M main git push -u origin main # 以后更新 git add . git commit -m "备注" git push进阶推荐
- 想学习更多Git命令：廖雪峰Git教程
- 想了解GitCode其他功能：查看官方文档 https://docs.gitcode.com/
- 项目有大文件需要管理：学习Git LFS
如果这篇教程帮到了你，欢迎点赞收藏！有问题评论区留言，看到必回！ 👍
