手把手教你用 Gitee 托管代码：从注册到代码上传全流程

作为国内主流的代码托管平台，Gitee（码云）凭借高速稳定的服务器、本地化的优质服务，成为众多开发者的首选。本文将详细演示如何在 Gitee 上完成账号注册、密码设置及代码上传，适合新手快速入门。

一、注册 Gitee 账号并设置密码

1. 注册账号

步骤 1：打开 Gitee 官网（https://gitee.com），点击右上角「注册」。
步骤 2：选择注册方式（手机号 / 邮箱 / 第三方登录），以手机号注册为例：

• 输入手机号，点击「获取验证码」，输入短信验证码。
• 设置登录密码（建议 8-20 位，包含字母、数字和符号）。
• 勾选用户协议，点击「立即注册」。

2. 完善账号安全设置（可选）

• 修改登录密码：登录后进入「设置」→「账号与安全」→「登录密码」，点击「修改密码」，按提示完成验证后设置新密码。
• 开启二次验证（推荐）：在「账号与安全」中选择「二次验证」，绑定手机或微信，提升账号安全性。

二、创建 Gitee 代码仓库

1. 新建仓库

• 登录后点击右上角「+」→「新建仓库」。
• 填写仓库信息：
  • 仓库名称：自定义（如 my-first-project）。
  • 描述：可选填项目简介。
  • 访问权限：公开仓库无需权限即可查看，私有仓库需授权成员。
  • 初始化仓库：建议勾选「添加 README 文件」和「使用.gitignore 模板」（可选编程语言模板过滤无关文件）。
• 点击「创建仓库」，进入仓库详情页。

三、本地环境配置（安装 Git 并配置凭证）

1. 安装 Git

• 访问 Git 官网 下载对应系统的安装包（Windows/macOS/Linux），按默认设置完成安装。

2. 配置 Git 用户名和邮箱（必做）

打开终端（Windows 用 Git Bash，macOS/Linux 用终端），输入以下命令（替换为你的 Gitee 账号邮箱和昵称）：

git config --global user.name "你的Gitee用户名"  
git config --global user.email "注册时使用的邮箱"  

3. 两种代码上传方式（HTTPS vs SSH）

方式一：使用 HTTPS（适合新手，直接输入账号密码）

优势：无需生成密钥，直接用 Gitee 账号密码认证。
步骤：

1. 在 Gitee 仓库详情页，复制 HTTPS 链接（如 https://gitee.com/your-username/my-first-project.git）。
2. 本地新建项目上传（首次提交）：

   # 创建本地项目文件夹并进入  
   mkdir my-project && cd my-project  
   # 初始化本地Git仓库  
   git init  
   # 添加文件（例如创建一个README.md）  
   echo "这是我的第一个Gitee项目" > README.md  
   # 提交文件到本地仓库  
   git add .  
   git commit -m "首次提交"  
   # 关联Gitee远程仓库（替换为你的仓库HTTPS链接）  
   git remote add origin https://gitee.com/your-username/my-first-project.git  
   # 推送代码到Gitee（第一次推送需添加 -u 参数绑定分支）  
   git push -u origin master  
   

   
   推送时会提示输入 Gitee 的注册手机号 / 邮箱和登录密码，输入后即可完成上传。

方式二：使用 SSH（适合长期使用，免密码登录）

优势：无需每次输入密码，安全性更高。
步骤：

1. 生成 SSH 密钥：

   ssh-keygen -t rsa -C "你的邮箱"  
   # 按回车默认保存路径，设置密码（可选）  
   

2. 复制密钥：
   • Windows：进入 C:\Users\你的用户名\.ssh\id_rsa.pub，用记事本打开并复制内容。
   • macOS/Linux：输入 cat ~/.ssh/id_rsa.pub 复制输出内容。
3. 在 Gitee「设置」→「SSH 公钥」中，粘贴密钥并保存，标题自定义（如「Work PC」）。
4. 测试连接：

   ssh -T git@gitee.com  
   # 出现 "Welcome to Gitee.com, your-username!" 即表示成功  
   

5. 关联仓库时使用 SSH 链接（在仓库详情页切换为 SSH 链接），后续推送无需输入密码。

四、上传已有项目到 Gitee

如果你已有本地项目（非 Git 仓库），步骤如下：

1. 在本地项目根目录打开终端，初始化 Git 仓库：

   git init  
   

2. 添加文件并提交：

   git add .  
   git commit -m "提交描述"  
   

3. 关联 Gitee 远程仓库（HTTPS/SSH 任选）：

   git remote add origin 你的仓库链接  
   

4. 推送代码（若远程仓库有 README 等文件，需先拉取合并）：

   git pull origin master --allow-unrelated-histories  
   git push -u origin master  
   

五、常见问题解决

1. 密码错误怎么办？

   • 确认输入的是 Gitee 的登录密码（非邮箱 / 其他平台密码），若忘记密码，在登录页点击「忘记密码」重置。
   • 若开启了二次验证，推送时需使用「私人令牌」代替密码（在 Gitee「设置」→「私人令牌」中生成，权限勾选 project）。

2. 远程仓库链接错误？

   • 检查仓库链接是否复制正确，确保以 .git 结尾（如 https://gitee.com/xxx/yyy.git）。

3. 文件上传失败？

   • 确保本地文件已通过 git add 和 git commit 提交，避免直接推送空仓库。

六、总结

通过 Gitee 托管代码，国内开发者能享受更快的访问速度和更友好的中文支持。本文覆盖了从注册、密码设置到代码上传的全流程，无论是新手还是有经验的开发者，都能通过清晰的步骤完成操作。建议优先使用 SSH 方式提升效率，同时注意保护账号安全（开启二次验证、定期更换密码）。

赶紧动手创建你的第一个 Gitee 仓库，体验高效的代码管理吧！ 🚀