本地代码上传 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 方式则需确保已配置好密钥。
