前言Gitee码云是国内最大的代码托管平台之一为开发者提供 Git 仓库托管、代码审查、项目管理、团队协作等一站式服务。与 GitHub 相比Gitee 在国内访问速度更快且支持免费私有仓库非常适合国内开发者、学生团队以及企业使用。本教程将从零开始手把手带你完成Gitee 账号注册、Git 客户端下载与安装、安装后检验以及基础配置四个步骤。无论你是编程新手还是刚接触版本控制的老手跟着本文操作一遍就能顺利搭建起自己的 Git 开发环境。准备好了吗让我们开始吧。一、注册 Gitee 账号1. 打开官网浏览器输入https://gitee.com进入码云官网。2. 进入注册页面点击页面右上角注册按钮。3. 注册注意如下提示手机号注册填写大陆手机号。设置密码8 位以上必须包含字母 数字。短信验证点击获取短信验证码填入收到的 6 位数字。设置用户名不可修改英文 数字个人主页地址靠它如gitee.com/zhangsan2026。同意协议勾选同意服务协议点击【立即注册】。完成自动登录注册完成。二、下载 GitGitee 底层依赖 Git因此需要先安装 Git。Git 官网下载https://git-scm.com/downloadsWindows下载 Windows 版本 exe一路默认安装。Mac终端输入xcode-select --install一键安装。安装验证文件夹右键出现「Git Bash Here」即成功。Git Windows 安装详解双击打开下载的 exe 文件点击Next开始安装。以下是各配置页面的详细解读与推荐选项。1. 选择组件 (Select Components选项说明推荐Additional icons(桌面图标)安装后桌面生成 Git 快捷方式。个人喜好可不勾选Windows Explorer integration(右键菜单)文件夹右键出现Open Git Bash here(高频使用) 和Open Git GUI here(新手可视化操作)。推荐勾选Git LFS(大文件支持)管理项目中的大文件图片、压缩包、模型文件。推荐勾选Associate .git* configuration files.gitignore、.gitconfig等配置文件双击可用编辑器打开。推荐勾选Associate .sh files to be run with BashWindows 下直接运行 Shell 脚本。推荐勾选Check daily for Git for Windows updates每日检测 Git 新版本。按需选择Add a Git Bash Profile to Windows Terminal系统自带终端内置 Git Bash。推荐勾选Scalar(超大仓库加速)针对百万文件超大仓库的加速插件普通项目用不上。可不勾选推荐除第 1 项外其余都推荐勾选。NEXT2. 选择默认分支名 (Choosing the default branch name)选项 1Let Git decide作用新建仓库时默认分支名为master是 Git 传统默认名称。适配老项目、旧教程大多使用master分支新手选这个不会出现命令不匹配的问题。选项 2Override the default branch name for new repositories作用强制所有新建仓库默认分支名为main是现在 GitHub、Gitee 等平台推荐的新标准。优势和 Gitee 网页端新建仓库默认分支名称统一后续推送代码时不会出现分支名冲突报错。推荐选项 1Let Git decide3. 调整 PATH 环境 (Adjusting your PATH environment)选项 1Use Git from Git Bash only仅能在 Git Bash 软件内执行 git 命令CMD、PowerShell、VS Code 等无法识别。适合仅使用 Git Bash 的用户新手不推荐。选项 2Git from the command line and also from 3rd-party software自动添加最小化 Git 工具至系统 PATH。支持 Git Bash、CMD、PowerShell、VS Code 等所有开发软件无冲突风险。选项 3Use Git and optional Unix tools from the Command Prompt会把 Linux/Unix 工具一并加入系统 PATH会覆盖 Windows 原生find、sort等命令存在冲突风险。推荐选项 2Git from the command line and also from 3rd-party software4. 选择 SSH 执行文件 (Choosing the SSH executable)选项 1Use bundled OpenSSH使用 Git 安装包自带的 OpenSSH 工具开箱即用版本适配配置 SSH 密钥连接 Gitee 时操作最简单。选项 2Use external OpenSSH调用 Windows 系统自带或手动安装的外部 OpenSSH若系统未预装或版本不兼容容易出现连接异常。推荐选项 1Use bundled OpenSSH5. 选择 HTTPS 传输后端 (Choosing HTTPS transport backend)选项 1Use the OpenSSL library使用 Git 自带的证书文件校验证书证书库独立于 Windows遇到系统私有证书会直接连接失败。选项 2Use the native Windows Secure Channel library调用 Windows 系统自带的证书库校验网站证书自动信任系统内所有证书访问 Gitee 不会出现证书报错。推荐选项 2Use the native Windows Secure Channel library6. 配置行结束符转换 (Configuring the line ending conversions)选项 1Checkout Windows-style, commit Unix-style line endings检出代码到本地时仓库的 LF 自动转为 Windows 的 CRLF提交代码到 Gitee 时本地 CRLF 自动转回标准 LF。完美兼容 Windows 编辑器同时保证线上仓库统一使用 LF跨平台协作无冲突。选项 2Checkout as-is, commit Unix-style line endings检出时不转换换行符提交时统一转 LF。Windows 用户容易出现记事本打开文件全挤在一行的问题。选项 3Checkout as-is, commit as-is检出、提交全程不做任何换行符转换。多人协作时会产生大量无关代码变更记录。推荐选项 1Checkout Windows-style, commit Unix-style line endings7. 选择终端模拟器 (Choosing the terminal emulator)选项 1Use MinTTYGit 自带的专用终端窗口可自由拉伸支持不规则文本框选复制粘贴更方便原生支持 Unicode 字符中文、注释不会出现乱码。选项 2Use Windows default console window调用系统 CMD 窗口运行 Git中文容易显示方框乱码文本只能矩形选择窗口缩放体验差。推荐选项 1Use MinTTY8. 选择git pull默认行为 (Choose the default behavior ofgit pull)选项 1Fast-forward or merge能快进合并就直接快进本地有提交、无法快进时自动生成一条合并提交记录。操作逻辑直观新手友好。选项 2Rebase拉取远程代码后把本地所有提交 “挪到” 远程最新代码之后提交历史干净线性但对新手不友好。选项 3Only ever fast-forward仅允许快进合并一旦本地存在未推送提交git pull命令直接报错终止。推荐选项 1Fast-forward or merge9. 选择凭据管理器 (Choosing a credential helper)选项 1Git Credential Manager跨平台账号凭据管理器首次登录 Gitee 输入账号密码后系统自动保存凭证后续git push/git pull无需重复登录。选项 2None不启用任何凭据存储工具每次操作都需要重新输入账号和密码操作繁琐。推荐选项 1Git Credential Manager10. 配置额外选项 (Configuring extra options)Enable file system caching开启文件缓存大幅提升文件读取、提交代码的速度推荐开启。Enable symbolic links符号链接功能需要 Windows 管理员权限普通写代码用不到保持未勾选状态。推荐勾选Enable file system caching然后点击Install开始安装。三、安装后检验按Win R输入cmd点击确定。在命令行中输入git --version如果显示version x.xx...即安装成功。四、基础配置安装完成后需要进行基础配置让 Git 知道你的身份。# 设置用户名你的 Gitee 用户名gitconfig--globaluser.name你的Gitee用户名#如 git config --global user.name CSDN# 设置邮箱注册 Gitee 的邮箱gitconfig--globaluser.email注册Gitee的邮箱#如 git config --global user.email CSDNqq.com验证是否成功输入以下指令gitconfig--global--list如果显示user.name和user.email就代表 Git 完整可用后续可以正常连接 Gitee 了。五、配置 SSH 密钥连接 Gitee为了让本地 Git 与 Gitee 远程仓库安全通信推荐使用 SSH 密钥认证。以下是完整配置步骤。1. 生成 SSH 密钥对打开终端Windows 使用 Git BashmacOS/Linux 使用系统终端执行以下命令ssh-keygen-ted25519-C你的Gitee注册邮箱# 例如ssh-keygen -t ed25519 -C CSDNqq.com执行后终端会提示Enter file in which to save the key直接按回车使用默认路径~/.ssh/id_ed25519。Enter passphrase可选直接回车表示不设置密码若设置则每次使用密钥时需输入密码。生成成功后会在~/.ssh/目录下得到两个文件文件说明id_ed25519私钥切勿泄露id_ed25519.pub公钥需要添加到 Gitee 账户2. 将公钥添加到 Gitee首先查看公钥内容cat~/.ssh/id_ed25519.pub复制输出的全部内容以ssh-ed25519开头以邮箱结尾的一整行字符串。然后登录 Gitee按以下步骤操作点击右上角头像 →设置在左侧菜单选择SSH公钥点击添加公钥按钮公钥标题任意填写如 “我的笔记本”公钥粘贴刚才复制的内容点击确定输入 Gitee 登录密码确认3. 测试连接在终端中执行以下命令验证 SSH 配置是否成功ssh-Tgitgitee.com首次连接会提示确认主机指纹输入yes后回车即可。如果看到类似以下输出说明 SSH 密钥配置成功Hi 你的Gitee用户名! Youve successfully authenticated, but GITEE.COM does not provide shell access.至此你的本地 Git 已可以通过 SSH 协议安全连接 Gitee后续克隆、推送、拉取代码都无需重复输入密码。