本地代码上传至 Gitee 的 Git 实战指南
在开发过程中,代码托管平台是团队协作与版本管理的核心工具。掌握将本地项目推送到 Gitee 或 GitHub 的流程,是每位开发者必备的技能。
Git 负责本地版本控制,而 Gitee 和 GitHub 则是托管这些仓库的平台。简言之,Git 管理历史,托管平台提供协作入口。下面介绍如何将项目上传到 Gitee,并解析相关概念与常见问题。
准备工作:明确工具角色
- Git:开源分布式版本控制工具,用于跟踪代码变更、回退版本及合并修改。
- Gitee:国内托管平台,访问速度快,支持私有仓库,适合国内团队。
- GitHub:全球知名托管平台,开源生态丰富,适合国际协作。
创建远程仓库
- 登录 Gitee 账号,点击右上角 + 号选择'新建仓库'。
- 填写仓库名称(如
my-project)、简介等信息。 - 初始化选项:若本地已有代码,建议不要勾选'添加 .gitignore'、'许可证'或'README',避免推送时产生冲突。
- 创建成功后复制仓库地址,格式通常为 HTTPS 或 SSH:
- HTTPS:
https://gitee.com/用户名/仓库名.git - SSH:
[email protected]:用户名/仓库名.git(需配置密钥)
- HTTPS:
初始化本地项目
全新项目
进入项目目录并执行以下命令:
cd /path/to/your/project
git init
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
git add .
git commit -m "first commit: 初始化项目"
已有 Git 管理的项目
若本地已初始化,跳过 git init 步骤,直接进行关联操作。
关联远程仓库并推送
-
绑定远程地址:
git remote add origin https://gitee.com/你的用户名/你的仓库名.git若提示
fatal: remote origin already exists,可执行git remote set-url origin ...修改。 -
验证关联:
git remote -v -
推送代码:
git push -u origin main注意:新版 Git 默认主分支为
main,旧版可能为master,请根据实际情况调整。 -
身份验证:
- HTTPS 方式会提示输入用户名和密码,建议使用个人访问令牌代替密码以提升安全性。
- SSH 方式需确保已配置公钥。


