创建Gitee仓库并推送本地项目至远程仓库

Git：版本控制工具，用于管理代码版本和推送代码
- 下载地址：https://git-scm.com/downloads
- 安装完成后，可在命令行输入git --version验证是否安装成功
Gitee账号：码云账号，用于创建和管理远程仓库
- 注册地址：https://gitee.com/signup

二、创建Gitee远程仓库

步骤1：登录Gitee账号

打开浏览器，访问Gitee官网（https://gitee.com/），输入账号密码登录。

步骤2：创建新仓库

登录后，点击右上角的「+」号按钮，在下拉菜单中选择「新建仓库」
在新建仓库页面，填写以下信息：
- 仓库名称：建议与本地项目名称一致（例如：my-project）
- 路径：会根据仓库名称自动生成，一般无需修改
- 仓库介绍：可选，简要描述项目功能
- 是否开源：根据需要选择「私有」或「公开」
- 初始化仓库：
  - 建议勾选「初始化README文件」
  - 可选择添加.gitignore（根据项目类型选择，如Node.js、Java等）
  - 许可证根据需要选择
填写完成后，点击「创建」按钮

步骤3：获取仓库地址

仓库创建成功后，在仓库页面可以看到仓库地址，有两种形式：

HTTPS地址：https://gitee.com/你的用户名/仓库名.git
SSH地址：git@gitee.com:你的用户名/仓库名.git（需要配置SSH密钥，推荐使用）

三、配置Git与Gitee连接（可选但推荐）

为了避免每次推送代码都输入账号密码，建议配置SSH密钥：

步骤1：生成SSH密钥

打开命令行工具（Windows：CMD或PowerShell；Mac/Linux：终端）
输入以下命令，按提示操作（一路回车即可）：
```
ssh-keygen -t ed25519 -C "你的邮箱地址"
```
注意：替换"你的邮箱地址"为你注册Gitee时使用的邮箱

步骤2：查看并复制公钥

根据操作系统，找到生成的公钥文件：
- Windows：C:\Users\你的用户名\.ssh\id_ed25519.pub
- Mac/Linux：~/.ssh/id_ed25519.pub
打开文件，复制里面的全部内容

步骤3：添加公钥到Gitee

登录Gitee，点击右上角头像，选择「设置」
在左侧菜单中找到「安全设置」→「SSH公钥」
填写「标题」（可自定义，如"我的笔记本"）
将复制的公钥内容粘贴到「公钥」文本框中
点击「确定」，并输入Gitee密码验证

步骤4：验证SSH连接

在命令行输入以下命令：

ssh -T git@gitee.com

首次连接会提示是否继续，输入yes后回车。如果看到"Welcome to Gitee.com…"的提示，说明配置成功。

四、推送本地项目到远程仓库

情况1：本地已有项目（未初始化Git）

步骤1：进入项目目录

在命令行中，切换到你的本地项目文件夹：

cd /path/to/your/project  # 替换为你的项目路径

步骤2：初始化Git仓库

git init

执行后，项目文件夹中会生成一个隐藏的.git目录（用于存储版本信息）

步骤3：将文件添加到暂存区

# 添加所有文件
git add .

# 或添加指定文件
git add 文件名1 文件名2

步骤4：提交文件到本地仓库

git commit -m "首次提交"  # 引号中是提交说明，建议写清楚本次提交的内容

步骤5：关联远程仓库

# 使用SSH地址（已配置SSH密钥时）
git remote add origin git@gitee.com:你的用户名/仓库名.git

# 或使用HTTPS地址
git remote add origin https://gitee.com/你的用户名/仓库名.git

步骤6：拉取远程仓库文件（如果远程仓库有初始化文件）

git pull origin master --allow-unrelated-histories

这一步是为了合并远程仓库的README等文件，避免后续推送冲突

步骤7：推送本地代码到远程仓库

git push -u origin master

首次推送使用-u参数，后续可直接使用git push
如果使用HTTPS地址，会提示输入Gitee的账号和密码

情况2：本地已有Git仓库（已使用Git管理）

如果你的项目已经是一个Git仓库，只需执行以下步骤：

关联远程仓库：
```
git remote add origin 你的仓库地址
```
如果之前关联过其他远程仓库，可先执行git remote rm origin删除

拉取远程仓库文件（如果需要）：

git pull origin master --allow-unrelated-histories

推送代码：
```
git push -u origin master
```

情况3：从远程仓库克隆到本地（新项目）

如果是全新项目，也可以先创建远程仓库，再克隆到本地：

克隆仓库：

# 使用SSH地址
git clone git@gitee.com:你的用户名/仓库名.git

# 或使用HTTPS地址
git clone https://gitee.com/你的用户名/仓库名.git

进入克隆的项目目录：
```
cd 仓库名
```

添加项目文件后，执行提交和推送：

git add .
git commit -m "添加项目文件"
git push

五、常见问题及解决办法

1. 推送时提示"fatal: remote origin already exists"

表示已经关联过远程仓库，解决方案：

# 先删除现有关联
git remote rm origin
# 再重新关联
git remote add origin 你的仓库地址

2. 拉取或推送时出现冲突

# 先拉取远程最新代码并合并
git pull origin master
# 解决冲突后，重新提交推送
git add .
git commit -m "解决冲突"
git push

3. 忘记提交信息或提交信息写错

# 提交信息写错，还未推送
git commit --amend
# 会进入编辑模式，修改后保存退出即可

4. 推送失败，提示权限不足

检查是否使用了正确的Gitee账号
若使用HTTPS地址，确认账号密码是否正确
若使用SSH地址，检查SSH密钥是否配置正确

六、常用Git命令总结

命令	作用
`git init`	初始化本地Git仓库
`git add .`	添加所有文件到暂存区
`git commit -m "说明"`	提交文件到本地仓库
`git remote add origin 地址`	关联远程仓库
`git pull origin master`	拉取远程仓库代码
`git push origin master`	推送本地代码到远程仓库
`git status`	查看文件状态
`git log`	查看提交记录

通过以上步骤，你就可以成功创建Gitee仓库并将本地项目推送到远程仓库了。后续开发中，只需在修改代码后执行git add .、git commit -m "说明"和git push这三个命令，即可将最新代码同步到远程仓库。