在开发过程中,代码托管平台是每个开发者的必备工具。无论你是刚接触版本控制的新手,还是拥有多项目管理经验的程序员,掌握如何将代码上传到 Gitee 都是必不可少的技能。
一、Git 与托管平台的关系
Git 是一款开源的分布式版本控制工具,负责本地管理代码历史、团队协作以及合并。简单来说,Git 是工具,而 Gitee 和 GitHub 是托管平台。
- Git:本地管理代码的版本控制工具。
- Gitee:国内代码托管平台,访问速度快,支持私有仓库,适合国内用户。
- GitHub:全球知名的 Git 托管平台,适用于开源项目,社区活跃。
Git 负责本地管理,Gitee/GitHub 用来托管代码,方便多人协作和在线访问。
二、将代码上传到 Gitee
上传代码主要分为三个环节:创建远程仓库、初始化本地项目、关联并推送。下面是详细的操作步骤。
1. 在 Gitee 创建远程仓库
- 登录 Gitee 账号,点击右上角 + 号选择 '新建仓库'。
- 填写仓库信息:
- 仓库名称:例如
my-project。 - 公开性:根据需求选择公开或私有。
- 初始化选项:建议不要勾选 '添加 .gitignore'、'许可证' 或 'README'。如果本地已有代码,勾选这些会生成额外文件,导致推送时冲突。
- 仓库名称:例如
- 创建成功后,复制仓库地址。格式如下:
- HTTPS:
https://gitee.com/你的用户名/你的仓库名.git - SSH:
[email protected]:你的用户名/你的仓库名.git(新手建议使用 HTTPS)。
- HTTPS:
2. 本地准备项目
进入终端,切换到你的项目目录:
cd /path/to/your/project
如果是全新项目(未使用 Git),执行以下命令初始化:
git init
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
git add .
git commit -m "first commit: 初始化项目"
如果项目已用 Git 管理,跳过 git init 及相关配置,直接进入下一步。
3. 关联远程仓库并推送
在本地项目文件夹中,执行以下命令关联 Gitee 仓库:
git remote add origin https://gitee.com/你的用户名/你的仓库名.git
若提示 fatal: remote origin already exists,可通过以下命令修改地址:
git remote set-url origin https://gitee.com/你的用户名/你的仓库名.git
验证关联是否成功:
git remote -v
最后推送代码:
git push -u origin main


