将本地项目上传到 Gitee（码云）仓库，操作步骤说明文档

将本地项目上传到 Gitee（码云）是一个很常见的需求。整个过程和 GitHub 类似，主要分为以下几个步骤：

### 第一步：准备工作

1.  **安装 Git**

   *   如果你还没有安装 Git，请先到 (https://git-scm.com/) 下载并安装。

   *   安装后，打开终端（Windows 是 Git Bash 或 CMD，Mac/Linux 是 Terminal），设置你的用户名和邮箱：

       ```bash

       git config --global user.name "你的用户名"

       git config --global user.email "你的邮箱"

       ```

2.  **拥有 Gitee 账户**

   *   如果你还没有，请先到(https://gitee.com/) 注册一个账户。

3.  **配置 SSH 公钥（推荐，更方便安全）**

   *   **生成公钥**：在终端运行 `ssh-keygen -t ed25519 -C "你的邮箱"`，一路回车即可。会在 `~/.ssh`（Windows 在 `C:\Users\你的用户名\.ssh`）目录下生成 `id_ed25519`（私钥）和 `id_ed25519.pub`（公钥）两个文件。

   *   **添加公钥到 Gitee**：

       1.  用文本编辑器打开 `id_ed25519.pub` 文件，复制全部内容。

       2.  登录 Gitee，点击头像 -> **设置** -> **SSH 公钥**。

       3.  将复制的公钥粘贴进去，标题会自动生成，点击 **确定** 即可。

### 第二步：在 Gitee 上创建远程仓库

1.  登录 Gitee，点击右上角的 **+** 号，选择 **新建仓库**。

2.  填写仓库信息：

   *   **仓库名称**：必填，例如 `my-project`。

   *   **路径**：会自动生成，和仓库名一致即可。

   *   **介绍**：选填。

   *   **是否开源**：选择 **公开** 或 **私有**（私有仓库仅自己或受邀者可见）。

   *   **初始化仓库**：**不要勾选** “使用 Readme 文件初始化这个仓库”。因为我们已经有本地项目了，如果勾选会导致后续推送冲突，需要先拉取合并，对新手不友好。

3.  点击 **创建**。

### 第三步：将本地项目初始化为 Git 仓库并推送

打开终端，进入你的**本地项目根目录**。

**方法一：全新项目首次推送（最常用）**

如果你的项目还没有被 Git 管理过，按顺序执行以下命令：

```bash

# 1. 初始化本地 Git 仓库

git init

# 2. 将项目所有文件添加到暂存区 (`.` 代表所有文件)

# 如果不想提交所有文件，可以先创建 .gitignore 文件来过滤

git add .

# 3. 提交到本地仓库，并写提交说明

git commit -m "first commit"

# 4. 添加远程仓库地址

# 将下面的 `你的用户名` 和 `仓库名` 替换成你自己的信息

# 注意：地址有 HTTPS 和 SSH 两种，推荐使用上面配置好的 SSH 地址

# SSH 地址格式（需要配置公钥）：

git remote add origin git@gitee.com:你的用户名/仓库名.git

# 或者 HTTPS 地址格式（每次推送需输入账号密码）：

# git remote add origin https://gitee.com/你的用户名/仓库名.git

# 5. 将本地代码推送到 Gitee 的 master/main 分支

# 如果远程分支是 main，则将下面的 master 改为 main

git push -u origin master

# 或者

git push -u origin main

```

*   `-u` 参数会在推送的同时，将本地 `master` 分支与远程 `origin/master` 分支关联起来，下次直接 `git push` 即可。

**方法二：已有 Git 仓库，更换或添加 Gitee 为远程仓库**

如果你的项目本来就用 Git 管理着（例如从 GitHub 克隆的），只需要添加 Gitee 的地址。

```bash

# 1. 查看现有的远程仓库地址 (通常叫 origin)

git remote -v

# 2. 如果 origin 已经是别的地址（如GitHub），可以重命名或删除后添加

# 方式A：直接添加一个新的远程仓库别名，例如叫 gitee

git remote add gitee git@gitee.com:你的用户名/仓库名.git

# 方式B：如果想替换原来的 origin

git remote remove origin # 先删除旧的

git remote add origin git@gitee.com:你的用户名/仓库名.git # 添加新的

# 3. 推送到 Gitee

# 如果远程仓库别名是 gitee

git push -u gitee master

# 如果远程仓库别名是 origin

git push -u origin master

```

### 第四步：验证

完成 `git push` 后，刷新你在 Gitee 上创建的仓库页面，就能看到你本地项目的所有文件都已经上传成功了。