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 个人资料完善
登录后点击右上角头像,进入"个人设置"。这里有几个关键配置需要注意:
- SSH公钥:后续代码提交会用到,可以先跳过,等安装好Git后再来配置
- 通知设置:建议开启重要通知的邮件提醒
- 隐私设置:根据需求设置仓库可见性
- 多因素认证:为账号安全,建议开启
3. Git环境安装与配置
3.1 Git的下载与安装
访问Git官网(https://git-scm.com)下载对应操作系统的安装包。Windows用户直接运行下载的.exe文件,安装过程中有几个关键选项需要注意:
- 选择默认编辑器:推荐使用VSCode或Nano,避免选择Vim(除非你熟悉)
- 调整PATH环境:选择"Git from the command line and also from 3rd-party software"
- 行尾转换:选择"Checkout as-is, commit Unix-style line endings"
- 终端模拟器:选择"Use Windows' default console window"
安装完成后,打开命令提示符或Git Bash,运行以下命令验证安装是否成功:
git --version3.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 status3.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/
安装时需要注意:
- 先安装Git,再安装TortoiseGit
- 选择安装简体中文语言包
- 安装完成后重启电脑使右键菜单生效
4.2 基础配置
安装完成后,在任何文件夹右键选择"TortoiseGit -> 设置",进行以下配置:
- 设置Git.exe路径(通常会自动检测到)
- 配置用户信息(与之前Git配置一致)
- 设置语言为中文(如果需要)
- 配置SSH客户端为Git自带的ssh.exe
4.3 常用操作
- 克隆仓库:右键选择"Git克隆",输入仓库URL(如git@gitee.com:username/repo.git)
- 提交更改:右键选择"Git提交 -> master",填写提交信息
- 推送更改:右键选择"Git推送"
- 拉取更新:右键选择"Git拉取"
- 查看日志:右键选择"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:
- 在目标文件夹右键选择"Git克隆"
- 输入仓库URL
- 点击确定
5.3 日常开发流程
- 创建新分支(建议每个功能/修复单独创建分支):
git checkout -b feature/new-feature进行代码修改
查看更改状态:
git status- 添加更改到暂存区:
git add . # 或者添加特定文件 git add file1.txt file2.txt- 提交更改:
git commit -m "描述性提交信息"- 推送分支到远程:
git push origin feature/new-feature- 在Gitee上创建Pull Request(合并请求)
5.4 解决常见问题
- 合并冲突:
- 拉取最新代码时如果出现冲突,需要手动解决
- 冲突文件会包含<<<<<<<, =======, >>>>>>>标记
- 编辑文件保留需要的部分,删除标记
- 然后执行git add和git commit完成合并
- 撤销更改:
# 撤销工作区修改 git checkout -- filename # 撤销暂存区修改 git reset HEAD filename # 撤销最近一次提交 git reset --soft HEAD~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功能,可以在代码推送时自动触发构建或部署流程。常见用法:
- 自动运行测试
- 自动部署到测试环境
- 自动构建Docker镜像
- 同步到其他代码托管平台
配置方法:仓库设置 -> WebHooks -> 添加WebHook,填写目标URL和触发事件。
7. 与其他工具集成
7.1 在VSCode中使用Gitee
- 安装Gitee插件:在VSCode扩展商店搜索"Gitee"并安装
- 登录:按F1打开命令面板,输入"Gitee: Login"并回车
- 克隆仓库:命令面板 -> "Gitee: Clone Repository"
- 提交更改:源代码管理面板 -> 输入提交信息 -> 点击√提交
- 推送更改:点击源代码管理面板的同步按钮
7.2 在IntelliJ IDEA中使用Gitee
- 安装Gitee插件:File -> Settings -> Plugins -> 搜索"Gitee"
- 登录:File -> Settings -> Version Control -> Gitee -> 添加账号
- 克隆项目:File -> New -> Project from Version Control -> Gitee
- 提交更改:右键项目 -> Git -> Commit Directory
- 推送更改:右键项目 -> Git -> Repository -> Push
7.3 使用Gitee Pages部署静态网站
- 确保仓库中有index.html文件
- 进入仓库 -> 服务 -> Gitee Pages
- 选择部署分支(通常是master或gh-pages)
- 点击启动
- 访问提供的URL即可查看网站
注意:免费用户的Gitee Pages需要手动更新,每次代码更新后需要重新部署。付费用户可以开启自动更新。