gitee 使用教程

前言

Gitee 是一个中国的开源代码托管平台，类似于 GitHub，旨在为开发者提供一个高效、稳定、安全的代码管理和协作开发环境。Gitee 支持 Git 协议，可以托管 Git 仓库，进行版本控制、代码协作、项目管理等操作。

1. Gitee 的主要功能
代码托管：Gitee 提供 Git 仓库托管服务，支持 Git 协议进行版本控制。用户可以创建个人仓库、组织仓库、私有仓库和公开仓库。

团队协作：支持多人协作开发，可以创建团队或组织，对团队成员进行权限管理，并协作开发项目。

项目管理：Gitee 提供问题追踪、任务分配、看板、里程碑等功能，帮助开发者管理项目进度和工作任务。

持续集成（CI/CD）：Gitee 支持与持续集成工具的集成，如 Gitee 自己的 CI 服务，可以实现代码的自动构建、测试和部署。

代码审查：Gitee 提供了 Pull Request（PR）功能，允许开发者在提交代码前进行代码审查、讨论和合并。

开源社区：Gitee 是中国最大的开源平台之一，拥有大量的开源项目，支持开发者创建、分享和参与开源项目。

2. Gitee 的优势
本地化服务：Gitee 是一个中文平台，所有的文档、界面和支持服务都提供中文支持，对于中国大陆的开发者来说，使用更加方便和直观。

稳定性和速度：由于 Gitee 数据中心位于中国，能够提供更快的访问速度和更高的稳定性，尤其在国内开发者使用时更具优势。

隐私保护：Gitee 提供了更强的数据隐私保护政策，特别适合国内公司和开发团队，避免了某些国际平台可能存在的隐私问题。

国内政策合规：Gitee 是符合中国政策法规的代码托管平台，可以帮助企业和个人更好地遵守国内的法律要求。

3. Gitee 的历史
创建背景：Gitee 由国内领先的云服务提供商 开源中国（OSChina） 提供支持。开源中国成立于 2008 年，Gitee 则是为了满足国内开发者对代码托管和协作平台的需求而诞生的。

发展历程：自成立以来，Gitee 逐步发展成为国内最大的代码托管平台之一，提供了很多独特的功能并不断优化用户体验。

4. 与其他平台的对比
与 GitHub：

GitHub 是全球最受欢迎的代码托管平台，拥有庞大的开源社区。Gitee 和 GitHub 的功能非常相似，都提供了代码托管、协作、问题追踪等功能。
区别在于，Gitee 专注于中国市场，提供中文界面和符合中国法规的服务，而 GitHub 更侧重于国际化和开放源代码的全球社区。
与 GitLab：

GitLab 是另一个开源的 Git 仓库托管平台，功能上与 Gitee 和 GitHub 相似。
Gitee 主要面向国内开发者，支持国内云服务和基础设施，GitLab 在全球范围内也有广泛的使用，但其在中国的访问速度和服务可能不如 Gitee。
5. 使用 Gitee 的典型场景
个人项目托管：Gitee 为开发者提供免费的公共仓库，适合用来托管个人开发的开源项目。
企业代码管理：企业可以使用 Gitee 来管理内部项目，利用 Gitee 提供的私有仓库、团队管理、权限控制等功能提高开发效率。
开源项目社区：开源项目开发者可以将项目托管在 Gitee 上，参与到国内的开源社区，获得更多的本土开发者支持。
团队协作与集成：通过 Gitee，开发团队可以实现代码版本控制、协作开发、持续集成、项目管理等全方位的工作流支持。
6. 如何使用 Gitee
创建账号：访问 Gitee 官网，注册账号即可开始使用。
创建仓库：注册后，可以通过 Gitee 创建个人或团队仓库，上传代码并进行版本控制。
提交代码：使用 Git 工具将本地代码提交到 Gitee 仓库。也可以通过 Gitee 提供的网页版界面进行代码编辑和提交。
参与开源：可以通过 Gitee 浏览和参与开源项目，提交代码和 Pull Request。
总结
Gitee 是一个强大的、国内领先的代码托管平台，适合个人开发者、团队及企业使用。它不仅为开发者提供了 Git 协议的版本控制、代码托管，还支持项目管理、团队协作、持续集成等功能。Gitee 的本地化优势使得它特别适合国内开发者，同时也推动了中国的开源生态发展。

 开始使用

一、首先需要注册自己的gitee账户，然后在本地下载 git 工具。

gitee官网地址：开源软件 - Gitee.com

git 软件工具官网：Git - 下载

2、创建用户名 和 邮箱 

配置用户名和邮箱
#配置用户名

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

#配置邮箱

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

查询配置：

git config --global --list

#生成ssh文件夹（生成ssh秘钥）输入以下命令

ssh-keygen -t rsa

生成一个新的 RSA 类型的 SSH 密钥对。这个密钥对通常用于安全地与 Git 服务器（如 GitHub、GitLab 等）进行身份验证。

敲击三次回车键。

文件存放目录：默认在C盘     \Users\用户名.ssh

将ssh文件夹中的公钥（ id_rsa.pub）添加到GitHub管理平台中（添加后会收到邮件提示）

获取ssh key公钥内容（id_rsa.pub）
方法1：
cd ~/.ssh
cat id_rsa.pub
方法2：
C:\Users\本机用户名\.ssh
找到id_rsa.pub  以记事本打开，把里面的内容全部复制到  1、Gitcode   2、用户设置   3、SSH密钥 里面去。
二、创建本地仓库

1. 安装 Git
确保你已经在你的计算机上安装了 Git。可以在终端输入以下命令检查 Git 是否已安装：

git --version    #查看版本，如果未安装，请访问 Git 官方网站 下载并安装。

2. 创建一个新目录（可选）
如果你想在一个新的文件夹中创建仓库，可以使用以下命令创建一个新目录并进入该目录：

mkdir 目录名  #创建新目录
cd 目录名       #切换到新目录

3. 初始化 Git 仓库
在项目的目录中，运行以下命令以初始化一个新的 Git 仓库：

git init

这将在当前目录下创建一个 .git 子目录，标志着该目录现在是一个 Git 仓库。

三、如何将本地文件提交远程giett仓库

1、从远程仓库拉取最新的代码并与本地代码合并。
git pull  <仓库URL>
2、将本地的所有修改添加到 Git 暂存区。
git add .
3、提交暂存区的修改，并附上提交信息。
git commit -m "更新"
4、将本地的提交推送到远程仓库的 master 分支。
git push <仓库URL>
 
四、如何从远程仓库下载文件到本地。

git clone <仓库URL>

补充：
通过SSH 协议 下载，需要 先设置SSH 密钥认证，如果你不想使用 SSH 密钥认证，你可以使用 HTTPS 协议来克隆仓库。
通过 HTTPS 克隆时，Git 会要求你输入 Gitee 的用户名和密码。

 五、Git 常用命令的总结

命令	描述	示例
git clone <仓库URL>	克隆远程仓库到本地	git clone https://gitee.com/username/repository.git
git status	查看当前工作目录和暂存区的状态	git status
git add <文件>	将指定文件添加到暂存区	git add README.md
git add .	将当前目录下的所有更改（包括新文件）添加到暂存区	git add .
git commit -m "<提交信息>"	提交暂存区的文件到本地仓库	git commit -m "Update README"
git push	将本地仓库的更改推送到远程仓库	git push origin main
git pull	拉取远程仓库的最新更新并合并到当前分支	git pull origin main
git fetch	从远程仓库获取最新更新，但不进行合并	git fetch origin
git branch	查看当前分支列表或当前分支	git branch
git branch <分支名>	创建新分支	git branch new-feature
git checkout <分支名>	切换到指定分支	git checkout feature-branch
git checkout -b <分支名>	创建并切换到新分支	git checkout -b new-feature
git merge <分支名>	合并指定分支到当前分支	git merge feature-branch
git rebase <分支名>	将当前分支变基到指定分支的最新提交	git rebase main
git log	查看提交历史	git log
git remote -v	查看远程仓库的 URL 地址	git remote -v
git remote add <远程仓库名> <仓库URL>	添加远程仓库	git remote add origin https://gitee.com/username/repository.git
git remote remove <远程仓库名>	移除远程仓库	git remote remove origin
git reset <文件>	撤销文件的修改（仅从暂存区移除文件，不影响工作区）	git reset README.md
git reset --hard	撤销所有本地修改（包括工作区和暂存区的更改）	git reset --hard
git rm <文件>	删除文件并将删除操作添加到暂存区	git rm README.md
git stash	暂时保存当前工作区的修改，恢复到上次提交的状态	git stash
git stash pop	恢复并删除最近一次的暂存保存	git stash pop
git stash apply	恢复最近一次的暂存保存，但不删除	git stash apply
git tag	查看所有标签	git tag
git tag <标签名>	为当前提交打标签	git tag v1.0
git push origin <标签名>	推送标签到远程仓库	git push origin v1.0
git push --tags	推送所有标签到远程仓库	git push --tags
git pull origin <分支名>	从远程仓库拉取指定分支的最新更新	git pull origin main
git fetch origin <分支名>	从远程仓库获取指定分支的最新更新	git fetch origin main

补充说明：

• git clone：用来将远程仓库的代码复制到本地。
• git status：查看当前本地代码和远程仓库状态的差异。
• git add：将修改过的文件添加到暂存区，准备提交。
• git commit：将暂存区的文件提交到本地仓库。
• git push：将本地仓库的提交推送到远程仓库。
• git pull：拉取远程仓库的更新并合并到当前分支。
• git branch：管理本地分支，查看、创建或删除分支。
• git checkout：切换分支或恢复文件。
• git merge：合并不同分支的更改。
• git reset：撤销更改，恢复到某个历史版本。
• git stash：暂时存储当前未完成的工作，方便切换到其他任务。

这些是 Git 在 Gitee 上常用的操作命令，可以帮助你进行常见的代码管理、分支操作、推送与拉取等任务。