从linux gitee

### 如何在 Linux 系统上使用 Gitee 进行代码托管和协作开发

#### 创建并配置本地 Git 仓库
为了能够在 Linux 上使用 Gitee 执行代码托管，首先需要安装 Git 版本控制系统。大多数 Linux 发行版默认已预装此工具；如果没有，则可以通过包管理器轻松获取。

一旦确认 Git 安装完毕，在终端输入以下命令初始化一个新的 Git 库：

git init my_project
cd my_project/

这会创建名为 `my_project` 的目录作为新的 Git 项目根文件夹[^2]。

#### 配置个人信息
首次设置 Git 或者更换工作环境时，建议先设定用户名与邮箱地址以便提交记录识别作者身份：

git config --global user.name "Your Name"
git config --global user.email you@example.com

上述指令中的 `"Your Name"` 和 `you@example.com` 替换成个人真实姓名以及电子信箱即可。

#### 将现有项目添加到版本控制下
对于已有源码但尚未纳入任何 VCS 跟踪状态下的情况，只需简单地把它们复制粘贴至之前通过 `git init` 初始化出来的文件夹里，并运行如下两条语句来标记所有改动准备推送远端服务器：

git add .
git commit -m "Initial project version"

这里 `-m` 参数后面跟的是此次更改的日志说明文字，可以根据实际情况调整成更具体的内容[^3]。

#### 关联远程仓库并与之同步数据
完成以上步骤之后就可以前往[Gitee](https://gitee.com/)网站建立对应的在线储存空间了——即所谓的“远程仓库”。假设已经成功建立了这样一个位置为 `https://gitee.com/username/repository.git` 的新库，则可以继续执行下面的操作将其链接回本地副本：

git remote add origin https://gitee.com/username/repository.git
git push -u origin master

其中 `origin` 是对所关联站点的习惯称呼而并非固定不变的名字；至于最后那条推送分支名 (`master`) 可能依据实际场景有所不同（比如某些情况下可能是 `main`），应当视具体情况灵活处理[^1]。

#### 日常维护更新流程
随着项目的不断演进，开发者们通常还需要定期向云端备份最新进展或是拉取他人贡献的部分成果。为此提供了两个常用动作：“推送上游”(`push`) 和 “下载下游”(`pull`) ：

- 推送当前分支上的全部修改至上一阶段指定好的目标主机处；

  git push origin branch_name

- 获取来自特定路径之下其他协作者分享过来的新东西并将这些变动集成进来

  git pull origin branch_name

值得注意的是当遇到冲突状况发生时，可能不得不手动编辑解决分歧之处再重新做一次提交才能顺利完成整个过程。

#### 控制存储库大小
考虑到长期积累下来的历史记录可能会造成不必要的膨胀现象影响性能表现，适时采取措施优化是非常必要的。除了遵循官方给出的一些最佳实践指导方针之外，也可以借助第三方插件如 `git-sizer` 来评估现状或者运用更为强大的重写历史功能 `git-filter-repo` 实现瘦身目的[^4]。