news 2026/8/12 10:20:49

Gitee代码托管平台使用指南与Git实战教程

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Gitee代码托管平台使用指南与Git实战教程

1. 为什么选择Gitee作为代码托管平台

在国内开发环境中,Gitee(码云)已经成为许多开发者和团队的首选代码托管平台。与GitHub相比,Gitee最大的优势在于其服务器位于国内,访问速度快且稳定,不会出现国外平台常见的连接超时问题。对于个人开发者而言,Gitee提供免费的私有仓库服务,这在GitHub上需要付费才能获得。

Gitee还针对中国开发者做了许多本地化优化,比如全中文界面、支持手机号注册、与国内主流开发工具深度集成等。平台内置的代码质量分析、项目管理看板等功能也非常适合中小团队协作开发。此外,Gitee Pages服务可以快速部署静态网站,对于个人博客或项目文档的发布非常方便。

提示:虽然Gitee功能强大,但如果是开源项目,建议同时在GitHub和Gitee上维护仓库,以扩大项目影响力。可以使用Gitee的仓库同步功能自动将GitHub仓库镜像到Gitee。

2. 注册Gitee账号与基础设置

2.1 账号注册流程

访问Gitee官网(https://gitee.com),点击右上角的"注册"按钮。Gitee支持三种注册方式:手机号注册、邮箱注册和第三方账号(微信、GitHub)登录。对于国内用户,推荐使用手机号注册,方便后续找回密码和接收重要通知。

注册时需要填写用户名,这个用户名将成为你个人主页的地址(如https://gitee.com/yourname),建议使用英文或数字组合,避免使用中文。注册完成后,建议立即设置账号的安全选项,包括绑定邮箱、设置密码保护问题等。

2.2 个人资料完善

登录后点击右上角头像,进入"个人设置"。这里有几个关键配置需要注意:

  1. SSH公钥:后续代码提交会用到,可以先跳过,等安装好Git后再来配置
  2. 通知设置:建议开启重要通知的邮件提醒
  3. 隐私设置:根据需求设置仓库可见性
  4. 多因素认证:为账号安全,建议开启

3. Git环境安装与配置

3.1 Git的下载与安装

访问Git官网(https://git-scm.com)下载对应操作系统的安装包。Windows用户直接运行下载的.exe文件,安装过程中有几个关键选项需要注意:

  1. 选择默认编辑器:推荐使用VSCode或Nano,避免选择Vim(除非你熟悉)
  2. 调整PATH环境:选择"Git from the command line and also from 3rd-party software"
  3. 行尾转换:选择"Checkout as-is, commit Unix-style line endings"
  4. 终端模拟器:选择"Use Windows' default console window"

安装完成后,打开命令提示符或Git Bash,运行以下命令验证安装是否成功:

git --version

3.2 基础Git配置

安装完成后需要先配置用户信息,这些信息会出现在你的提交记录中:

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

推荐配置一些常用别名,提高工作效率:

git config --global alias.co checkout git config --global alias.br branch git config --global alias.ci commit git config --global alias.st status

3.3 生成SSH密钥并添加到Gitee

SSH密钥用于安全地连接Gitee服务器,无需每次输入密码。生成密钥对:

ssh-keygen -t ed25519 -C "your_email@example.com"

生成过程中会询问保存位置(直接回车使用默认位置)和密码(可选)。生成后,使用以下命令查看公钥内容:

cat ~/.ssh/id_ed25519.pub

复制输出的全部内容,登录Gitee,进入"SSH公钥"设置页面(设置 -> SSH公钥),添加新的公钥。标题可以随意填写,公钥内容粘贴刚才复制的文本。

验证SSH连接是否成功:

ssh -T git@gitee.com

第一次连接会询问是否继续,输入yes即可。如果看到"Welcome to Gitee.com, YourName!"的欢迎信息,说明配置成功。

4. TortoiseGit(小乌龟)安装与使用

4.1 TortoiseGit安装

TortoiseGit是Windows下最流行的Git图形化客户端,下载地址:https://tortoisegit.org/download/

安装时需要注意:

  1. 先安装Git,再安装TortoiseGit
  2. 选择安装简体中文语言包
  3. 安装完成后重启电脑使右键菜单生效

4.2 基础配置

安装完成后,在任何文件夹右键选择"TortoiseGit -> 设置",进行以下配置:

  1. 设置Git.exe路径(通常会自动检测到)
  2. 配置用户信息(与之前Git配置一致)
  3. 设置语言为中文(如果需要)
  4. 配置SSH客户端为Git自带的ssh.exe

4.3 常用操作

  1. 克隆仓库:右键选择"Git克隆",输入仓库URL(如git@gitee.com:username/repo.git)
  2. 提交更改:右键选择"Git提交 -> master",填写提交信息
  3. 推送更改:右键选择"Git推送"
  4. 拉取更新:右键选择"Git拉取"
  5. 查看日志:右键选择"Git日志"

TortoiseGit最大的优势在于与Windows资源管理器的深度集成,几乎所有Git操作都可以通过右键菜单完成,特别适合不习惯命令行的开发者。

5. 代码提交全流程实战

5.1 创建新仓库

登录Gitee,点击右上角"+"号选择"新建仓库"。填写仓库名称、描述,选择公开或私有。初始化选项建议:

  • 初始化README文件:勾选
  • 选择.gitignore:根据项目类型选择(如Java、Python等)
  • 选择开源许可证:根据需求选择(MIT、Apache等)

创建完成后,会显示仓库的HTTPS和SSH地址,复制这个地址用于后续克隆操作。

5.2 克隆仓库到本地

使用命令行:

git clone git@gitee.com:username/repo.git cd repo

或者使用TortoiseGit:

  1. 在目标文件夹右键选择"Git克隆"
  2. 输入仓库URL
  3. 点击确定

5.3 日常开发流程

  1. 创建新分支(建议每个功能/修复单独创建分支):
git checkout -b feature/new-feature
  1. 进行代码修改

  2. 查看更改状态:

git status
  1. 添加更改到暂存区:
git add . # 或者添加特定文件 git add file1.txt file2.txt
  1. 提交更改:
git commit -m "描述性提交信息"
  1. 推送分支到远程:
git push origin feature/new-feature
  1. 在Gitee上创建Pull Request(合并请求)

5.4 解决常见问题

  1. 合并冲突:
  • 拉取最新代码时如果出现冲突,需要手动解决
  • 冲突文件会包含<<<<<<<, =======, >>>>>>>标记
  • 编辑文件保留需要的部分,删除标记
  • 然后执行git add和git commit完成合并
  1. 撤销更改:
# 撤销工作区修改 git checkout -- filename # 撤销暂存区修改 git reset HEAD filename # 撤销最近一次提交 git reset --soft HEAD~1
  1. 忽略文件: 在项目根目录创建.gitignore文件,添加需要忽略的文件模式,如:
*.log node_modules/ .idea/

6. 高级技巧与最佳实践

6.1 提交信息规范

良好的提交信息有助于团队协作和后期维护。推荐使用以下格式:

类型(范围): 简短描述 详细描述(可选) 相关issue(如#123)

常见类型:

  • feat:新功能
  • fix:错误修复
  • docs:文档变更
  • style:代码格式调整
  • refactor:代码重构
  • test:测试相关
  • chore:构建过程或辅助工具的变动

6.2 分支管理策略

推荐使用Git Flow分支模型:

  • master:主分支,始终保持可发布状态
  • develop:开发分支,集成各个功能
  • feature/*:功能开发分支
  • release/*:预发布分支
  • hotfix/*:紧急修复分支

6.3 使用.gitattributes统一换行符

在项目根目录创建.gitattributes文件,内容如下:

* text=auto *.sh text eol=lf *.bat text eol=crlf

这样可以确保不同操作系统下的开发人员不会因为换行符问题产生大量无意义修改。

6.4 使用Gitee的Webhook实现CI/CD

Gitee支持Webhook功能,可以在代码推送时自动触发构建或部署流程。常见用法:

  1. 自动运行测试
  2. 自动部署到测试环境
  3. 自动构建Docker镜像
  4. 同步到其他代码托管平台

配置方法:仓库设置 -> WebHooks -> 添加WebHook,填写目标URL和触发事件。

7. 与其他工具集成

7.1 在VSCode中使用Gitee

  1. 安装Gitee插件:在VSCode扩展商店搜索"Gitee"并安装
  2. 登录:按F1打开命令面板,输入"Gitee: Login"并回车
  3. 克隆仓库:命令面板 -> "Gitee: Clone Repository"
  4. 提交更改:源代码管理面板 -> 输入提交信息 -> 点击√提交
  5. 推送更改:点击源代码管理面板的同步按钮

7.2 在IntelliJ IDEA中使用Gitee

  1. 安装Gitee插件:File -> Settings -> Plugins -> 搜索"Gitee"
  2. 登录:File -> Settings -> Version Control -> Gitee -> 添加账号
  3. 克隆项目:File -> New -> Project from Version Control -> Gitee
  4. 提交更改:右键项目 -> Git -> Commit Directory
  5. 推送更改:右键项目 -> Git -> Repository -> Push

7.3 使用Gitee Pages部署静态网站

  1. 确保仓库中有index.html文件
  2. 进入仓库 -> 服务 -> Gitee Pages
  3. 选择部署分支(通常是master或gh-pages)
  4. 点击启动
  5. 访问提供的URL即可查看网站

注意:免费用户的Gitee Pages需要手动更新,每次代码更新后需要重新部署。付费用户可以开启自动更新。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/8/12 10:20:42

Python AI工程师入门:从环境搭建到核心语法与NumPy实战

1. 从“Hello World”到AI工程师&#xff1a;为什么Python是起点 如果你点开这篇文章&#xff0c;大概率是想知道怎么成为一名AI工程师&#xff0c;并且已经听说Python是绕不开的第一步。没错&#xff0c;无论你搜索的是“AI算法工程师 招聘”还是“python安装教程”&#xff…

作者头像 李华
网站建设 2026/8/12 10:20:05

网盘直链下载助手LinkSwift:免费获取9大网盘真实下载地址的终极指南

网盘直链下载助手LinkSwift&#xff1a;免费获取9大网盘真实下载地址的终极指南 【免费下载链接】Online-disk-direct-link-download-assistant 一个基于 JavaScript 的网盘文件下载地址获取工具。基于【网盘直链下载助手】修改 &#xff0c;支持 百度网盘 / 阿里云盘 / 中国移…

作者头像 李华
网站建设 2026/8/12 10:18:46

3分钟极速排版:让《经济研究》投稿从噩梦变美梦的LaTeX神器

3分钟极速排版&#xff1a;让《经济研究》投稿从噩梦变美梦的LaTeX神器 【免费下载链接】Chinese-ERJ 《经济研究》杂志 LaTeX 论文模板 - LaTeX Template for Economic Research Journal 项目地址: https://gitcode.com/gh_mirrors/ch/Chinese-ERJ 还在为《经济研究》期…

作者头像 李华
网站建设 2026/8/12 10:17:32

MAIGateway,魔芋企业级AI网关的Token配额与预算设计

8月8日&#xff0c;Anthropic在X平台放出一个更新。从Claude Code v2.1.224版本开始&#xff0c;不同会话之间可以互相发送消息。 听上去是个小功能。但我想了一下它的含义&#xff1a;一个开发者可以同时开多个Claude Code会话&#xff0c;这些会话能互相通信、协同工作。一个…

作者头像 李华
网站建设 2026/8/12 10:17:23

京东自动化脚本完整指南:如何实现24小时不间断京豆收益

京东自动化脚本完整指南&#xff1a;如何实现24小时不间断京豆收益 【免费下载链接】jd_scripts-lxk0301 长期活动&#xff0c;自用为主 | 低调使用&#xff0c;请勿到处宣传 | 备份lxk0301的源码仓库 项目地址: https://gitcode.com/gh_mirrors/jd/jd_scripts-lxk0301 …

作者头像 李华
网站建设 2026/8/12 10:15:55

本地LLM推理部署实战:Ollama与llama.cpp对比与配置指南

在实际项目中&#xff0c;我们常常需要将大型语言模型&#xff08;LLM&#xff09;集成到自己的应用里&#xff0c;比如构建一个智能客服、一个代码助手&#xff0c;或者一个内部知识问答系统。直接调用云端API虽然方便&#xff0c;但会带来数据隐私、网络延迟、调用成本和模型…

作者头像 李华