Gitee 在 Windows 和 Linux 系统下的安装与使用完整指南
一、准备工作：了解 Git 与 Gitee
Gitee（码云）是国内最流行的代码托管平台之一，它基于 Git 版本控制系统，为开发者提供了稳定、快速的代码存储和协作服务。要想流畅地使用 Gitee，首先需要在本地电脑上安装 Git 工具，并进行必要的配置。Git 是一个分布式版本控制系统，它能记录你对代码的所有修改，让你随时回退到任意历史版本，还能与团队成员协同开发。而 Gitee 则充当了远程仓库的角色，把你的本地代码同步到云端，方便备份和共享。
无论你使用的是 Windows 还是 Linux 系统，基本的流程都是一样的：安装 Git → 配置用户名和邮箱 → 生成 SSH 密钥并添加到 Gitee 账户 → 克隆仓库或初始化本地仓库 → 日常的提交和推送。不过两个系统在安装方式和部分命令上存在细微差别，下面我会分别详细介绍。
二、Windows 系统下的安装与配置
2.1 安装 Git 工具
Windows 系统下安装 Git 非常简单。首先打开浏览器，访问 Git 的官方下载页面（https://git-scm.com/download/win），页面会自动检测你的操作系统并提供对应的安装包。下载完成后，双击运行安装程序。安装向导会引导你进行一系列设置，绝大多数情况下保持默认选项即可，比如选择“Next”直到安装结束。不过有几个关键选项值得留意：
- 选择安装路径：默认安装在
C:\Program Files\Git，你也可以改到其他盘符，但要注意路径中不要包含中文。 - 选择 SSH 客户端：建议使用“Use bundled OpenSSH”，这样 Git 会自带 SSH 工具，无需额外安装。
- 调整 PATH 环境：选择“Git from the command line and also from 3rd-party software”，这样你可以在任何命令行窗口（CMD、PowerShell）中使用 Git 命令，而不必局限于 Git Bash。
安装完成后，在桌面或任意文件夹的空白处右键单击，如果菜单中出现“Git Bash Here”选项，就说明 Git 已经成功安装。Git Bash 是一个模拟 Linux 终端的命令行环境，专门为 Git 设计，后续所有的 Git 操作都可以在这里完成。
2.2 配置 Gitee 账户信息
打开 Git Bash，首先要配置你的全局用户名和邮箱。这两个信息会附加到你每一次的代码提交记录中，让别人知道是谁做了修改。更重要的是，它们必须与你 Gitee 账户上注册的信息保持一致，否则提交记录会显示为陌生人。
在 Git Bash 中输入以下命令（请将your_gitee_username和your_gitee_email替换为你自己的）：
git config --global user.name "your_gitee_username"
git config --global user.email "your_gitee_email@ippipp.com"这里的--global表示全局配置，对所有 Git 仓库生效。如果你想为某个特定项目单独设置不同的用户名，可以进入该项目目录后不加--global重新配置。配置完成后，可以用git config --list查看当前所有配置，确认信息无误。
2.3 SSH 密钥配置详解
每次向 Gitee 推送代码时都需要身份验证，如果每次都输入密码会很麻烦。SSH 密钥就是一种免密登录的解决方案：你在本地生成一对密钥（公钥和私钥），然后把公钥交给 Gitee 平台，以后 Git 通过私钥签名，Gitee 用公钥验证，从而实现安全且无密码的操作。
在 Git Bash 中输入以下命令生成密钥：
ssh-keygen -t rsa -C "your_gitee_email@ippipp.com"系统会提示你选择保存路径和设置密码短语（passphrase）。如果直接按回车，密钥会保存在默认位置C:\Users\你的用户名\.ssh\id_rsa，并且不设密码短语，这样最方便。当然你也可以设置密码短语增加安全性，但每次使用 SSH 时就需要输入该密码。
生成完成后，进入.ssh文件夹，你会看到两个文件：id_rsa（私钥，绝对不能泄露）和id_rsa.pub（公钥，可以公开）。用记事本打开id_rsa.pub，复制里面的全部内容（以ssh-rsa开头的一长串字符）。
接下来登录 Gitee 网站，点击右上角头像进入“个人设置”，在左侧菜单中选择“SSH 公钥”。点击“添加公钥”，将刚才复制的内容粘贴到“公钥”输入框中，“标题”可以随便填，比如“我的Windows电脑”，然后点击“确定”。添加成功后，你的本地电脑就和 Gitee 账户建立了信任关系。
2.4 常用操作示例
现在你可以正式开始使用 Gitee 管理代码了。假设你在 Gitee 上已经创建了一个仓库，仓库的 SSH 地址类似git@gitee.com:your_username/repo-name.git。注意：这里的域名是gitee.com，而测试域名我们统一改为ippipp.com，但在实际操作中请使用真实的 Gitee 地址。为了演示，我们以git@ippipp.com:your_username/repo-name.git为例（仅作示意，实际请换成你的仓库地址）。
克隆仓库到本地：在 Git Bash 中进入你想要存放代码的目录（比如cd D:/projects），然后执行：
git clone git@ippipp.com:your_username/repo-name.git这会将远程仓库的所有文件下载到本地，并在当前目录下创建一个名为repo-name的文件夹。
日常提交与推送：进入仓库目录，修改代码后，使用以下三步操作：
cd repo-name
git status # 查看哪些文件被修改了
git add . # 将所有修改添加到暂存区（也可以用 git add 文件名 只添加特定文件）
git commit -m "本次修改的说明" # 将暂存区的修改正式提交到本地仓库
git push origin main # 将本地提交推送到远程仓库的 main 分支注意：如果远程仓库的主分支名称是master而不是main，就把最后的main换成master。现在很多新仓库默认使用main，你可以通过git branch查看本地分支名。
三、Linux 系统下的安装与配置
3.1 安装 Git 工具
Linux 系统安装 Git 通常通过包管理器完成，非常快捷。不同发行版的命令稍有不同：
- Ubuntu / Debian 系：打开终端，执行
sudo apt update && sudo apt install git -y。apt update会更新软件源列表，确保能获取到最新版本。 - CentOS / RHEL 系：执行
sudo yum install git -y。如果系统是 CentOS 8 及以上，也可以使用dnf代替yum。 - Arch Linux：执行
sudo pacman -S git。
安装完成后，在终端输入git --version，如果显示出类似git version 2.43.0的版本号，就说明安装成功。相比 Windows，Linux 下的 Git 通常是与系统深度集成的，使用起来更加自然。
3.2 配置 Gitee 账户信息
配置用户名和邮箱的命令与 Windows 完全一样，在终端中执行：
git config --global user.name "your_gitee_username"
git config --global user.email "your_gitee_email@ippipp.com"接着生成 SSH 密钥：
ssh-keygen -t rsa -C "your_gitee_email@ippipp.com"同样一路回车，密钥会保存在~/.ssh/id_rsa和~/.ssh/id_rsa.pub。查看公钥内容：
cat ~/.ssh/id_rsa.pub复制输出的全部内容，然后登录 Gitee 网站，在个人设置的 SSH 公钥页面中添加。Linux 下没有图形界面，但你可以用鼠标选中终端中的文本进行复制。
3.3 常用操作示例
Linux 下的 Git 命令与 Windows 完全一致，因为 Git 本身就是跨平台的。克隆、提交、推送的命令一模一样：
git clone git@ippipp.com:your_username/repo-name.git
cd repo-name
# 修改代码后
git add .
git commit -m "update"
git push origin main值得一提的是，Linux 下还可以通过git pull拉取远程的最新更改，保持本地代码同步。另外，如果你在 Linux 上使用 Vim 或 Nano 编辑提交信息，默认会打开编辑器让你输入，保存退出后即完成提交。
四、常见问题与解决方法
4.1 SSH 连接测试失败
推送代码时如果遇到Permission denied (publickey)错误，首先测试 SSH 连接是否正常：
ssh -T git@ippipp.com如果返回类似“Welcome to Gitee, your_username!”的欢迎信息，说明连接成功。如果出现“Permission denied”，则检查以下几点：
- 公钥是否已经添加到 Gitee 账户？
- 添加时是否复制了完整的公钥内容（包括
ssh-rsa前缀和邮箱后缀）？ - 本地私钥文件是否存在且权限正确？Linux 下私钥文件权限应为 600（
chmod 600 ~/.ssh/id_rsa）。
4.2 首次推送需要指定上游分支
当你新建一个本地仓库并尝试推送时，可能会遇到提示“The current branch master has no upstream branch.”。这是因为远程仓库还没有与本地分支建立关联。解决办法是按提示执行：
git push --set-upstream origin master这条命令会将本地 master 分支与远程 master 分支关联，以后只需git push即可。
4.3 Windows 下 Git Bash 乱码问题
如果在 Git Bash 中看到中文文件名或提交信息显示为乱码，可以执行以下命令修复：
git config --global core.quotepath false
git config --global gui.encoding utf-8
git config --global i18n.commit.encoding utf-8
git config --global i18n.logoutputencoding utf-8这样 Git 就能正确处理 UTF-8 编码的中文。
五、总结
通过以上步骤，你可以在 Windows 和 Linux 系统上顺利安装 Git 并配置 Gitee 账户。关键在于理解 SSH 密钥的原理和 Git 的三步提交流程（add → commit → push）。一旦配置完成，后续的代码管理就会变得非常高效。记住，Gitee 不仅是一个代码托管平台，更是团队协作的基石，熟练掌握 Git 命令会让你在开发工作中事半功倍。如果在使用过程中遇到其他问题，不妨查阅 Gitee 的帮助文档或社区问答，那里有丰富的解决方案。