本地代码上传 Gitee 实战指南
在开发过程中,代码托管平台是每个开发者的必备工具。掌握如何将代码上传到 Gitee 或 GitHub 是版本控制的基础技能。
Git 作为开源的分布式版本控制工具,负责本地管理代码历史、团队协作及合并;而 Gitee 和 GitHub 则是托管这些仓库的平台。简单来说,Git 是引擎,Gitee/GitHub 是车库。对于国内开发者,Gitee 通常提供更快的访问速度和更好的私有仓库支持。
一、环境准备与配置
首次使用 Git 前,需要配置用户信息以便提交记录能正确标识作者身份:
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
如果项目已存在 Git 管理,可跳过初始化步骤直接进行关联。
二、创建远程仓库
- 登录 Gitee 并点击右上角 + 号选择 '新建仓库'。
- 填写仓库名称(如
my-project),设置公开性或私有性。 - 注意:若本地已有代码,建议不要勾选'添加 .gitignore'、'许可证'或'README',以免产生文件冲突。
- 创建成功后复制仓库地址,格式通常为 HTTPS 或 SSH:
- HTTPS:
https://gitee.com/用户名/仓库名.git - SSH:
[email protected]:用户名/仓库名.git
- HTTPS:
新手建议使用 HTTPS 格式,避免 SSH 密钥配置的复杂性。
三、本地项目初始化与推送
全新项目
进入项目目录并初始化 Git:
cd /path/to/your/project
git init
将文件加入暂存区并提交:
git add .
git commit -m "first commit: 初始化项目"
关联远程仓库
执行以下命令将本地仓库与 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 默认主分支为 main,旧版可能为 master:
git push -u origin main
如果是 HTTPS 方式,系统会提示输入账号密码。出于安全考虑,建议生成 个人访问令牌 代替密码使用。SSH 方式则需确保已配置好密钥。


