Git 新手实战：从零把本地代码上传到 Gitee
雅洁 发布于
一、前言
最近在 GitHub 上看到一个不错的开源项目，想自己改着玩玩，顺便把代码托管到国内的 Gitee 上。作为一个 Git 小白，这一路遇到了不少坑，特此记录成文，希望能帮到同样刚接触 Git 的朋友。
二、准备工作
在开始之前，你需要准备好以下三样东西：
| 项目 | 说明 |
|---|---|
| Gitee 账号 | 去 gitee.com 注册一个 |
| Git 工具 | 下载安装 Git，安装后右键菜单会有 Git Bash Here |
| 本地代码 | 准备好你要上传的项目文件夹 |
三、完整操作步骤
第 1 步：在 Gitee 上创建远程仓库
- 登录 Gitee，点击右上角的 "+" 号，选择 "新建仓库"。
- 填写仓库名称（比如
test_myfirst），建议用英文，不要用中文。 - 建议先不要勾选"使用 Readme 文件初始化这个仓库"，保持仓库为空，避免后续推送时产生冲突。
- 如果账号要求 2FA（两步验证），可以先选"私有"创建，创建成功后去仓库设置里改成"公开"。
- 点击"创建"，保存好仓库地址（类似
https://gitee.com/你的用户名/仓库名.git），后面要用。
💡 为什么起英文名？ Gitee 的仓库名只支持字母、数字、下划线和连字符，不支持中文和空格。
第 2 步：初始化本地 Git 仓库
在你的项目文件夹里，右键空白处，选择 Git Bash Here（或使用 Windows PowerShell 终端）。
依次执行以下命令：
# 1. 初始化 Git 仓库（在本地建立版本管理）
git init
# 2. 配置用户身份（这一步必须做，否则无法提交）
git config --global user.name "你的Gitee用户名"
git config --global user.email "你的邮箱@qq.com"💡 这一步的作用：
git init会在当前文件夹创建一个.git隐藏文件夹，Git 的所有版本记录都存放在这里。
第 3 步：添加文件并提交到本地仓库
# 1. 把所有文件添加到暂存区
git add .
# 2. 提交到本地仓库
git commit -m "首次提交"💡 命令解释：
git add .：.代表当前文件夹下的所有文件，会把所有改动都放到暂存区。git commit -m "xxx"：-m是 message（备注）的缩写，后面跟的是本次提交的说明。
可能遇到的问题：
如果执行 git commit 时报错：
Author identity unknown
*** Please tell me who you are.说明你没有设置用户身份，执行第 2 步的 git config 命令即可解决。
第 4 步：关联远程仓库并推送
# 1. 添加远程仓库地址
git remote add origin https://gitee.com/你的用户名/你的仓库名.git
# 2. 推送到远程仓库
git push -u origin master💡 为什么叫 origin？
origin是 Git 默认的远程仓库别名，"源头"，你也可以理解成给远程地址起了一个昵称。
第 5 步：解决推送过程中可能遇到的报错
报错 1：remote origin already exists
原因： 之前已经关联过远程仓库（比如项目是从 GitHub 克隆下来的，默认指向 GitHub）。
解决方法： 先查看当前关联的地址：
git remote -v如果地址不对，修改为新的 Gitee 地址：
git remote set-url origin https://gitee.com/你的用户名/你的仓库名.git 报错 2：error: src refspec master does not match any
原因： 本地分支名不是 master，主流平台的默认分支名是 main。
解决方法： 把 master 改成 main：
git push -u origin main报错 3：failed to push some refs
原因： 远程仓库有文件（比如创建时勾选了 Readme 初始化），和本地冲突。
解决方法： 先拉取远程内容再推送：
git pull --rebase origin main
git push -u origin main四、常用命令速查表
| 命令 | 作用 |
|---|---|
git init |
在当前文件夹初始化 Git 仓库 |
git add . |
把所有修改过的文件添加到暂存区 |
git commit -m "备注" |
提交到本地仓库并添加备注 |
git remote -v |
查看当前关联的远程仓库地址 |
git remote add origin 地址 |
关联远程仓库 |
git remote set-url origin 新地址 |
修改远程仓库地址 |
git push -u origin main |
推送并关联远程分支（首次推送） |
git push |
后续推送（省略分支名） |
git pull |
拉取远程仓库的最新代码 |
五、总结
回顾整个流程，其实就三步核心操作：
git add .
git commit -m "说明"
git push理解这三条命令的含义，你就能应对绝大多数日常代码托管需求。遇到报错不要慌，看清错误提示，再结合 git remote -v 等命令检查当前状态，基本都能解决。
希望这篇文章能帮到你。如有其他问题，欢迎在评论区交流讨论！