跳到主要内容Gitee 与 Git 入门指南:从零开始掌握版本控制 | 极客日志编程语言
Gitee 与 Git 入门指南:从零开始掌握版本控制
Gitee 是国内常用的代码托管平台,结合 Git 版本控制系统可有效管理项目历史与协作。本文介绍从零开始配置 Gitee 账号与 Git 环境的方法,涵盖 Windows 与 Mac 系统安装步骤、SSH 密钥生成及仓库连接。通过实战演示首次代码提交流程,包括初始化仓库、添加文件、提交记录及推送到远程。此外还包含日常拉取更新、分支操作、冲突解决及常见问题排查技巧,帮助开发者快速掌握版本管理核心技能,提升协作效率。
Elasticer3 浏览 开篇:我的第一次'提交恐惧'
三年前,我还在用最原始的方式管理代码:
- 项目 1.0 →
project_v1_final.zip
- 改了点 bug →
project_v1_final_fixed.zip
- 同事要了最新版 →
project_v1_final_fixed_really_final.zip
直到有一天,我误删了关键文件,翻遍十几个'final'压缩包也找不回来,才下定决心学 Git。结果一打开教程,满屏的'暂存区'、'远程仓库'、'rebase'——瞬间想放弃。
现在,我每天用 Gitee 管理十几个项目,带的新人也从'完全不懂'到'熟练提交'。今天,我把这套方法完整分享给你。
一、先搞懂:Gitee 到底是干什么的?
1. 生活比喻:Gitee 就像'代码的网盘 + 时光机'
- 网盘功能:你把代码传到 Gitee(就像传文件到百度云),换个电脑也能下载,还能分享给同事;
- 时光机功能:每次修改都保存一个'快照',随时能回到任意时间点(比如回到昨天没写 bug 的时候);
- 协作功能:多人同时改代码,自动合并,不会互相覆盖。
2. 为什么要用 Gitee 而不是 GitHub?
- 访问速度:Gitee 是国内服务器,上传下载快(GitHub 国外服务器,经常卡顿);
- 中文界面:全中文,对小白友好;
- 免费私有仓库:个人项目不想公开?Gitee 免费提供私有仓库(GitHub 私有仓库要收费)。
3. 核心概念一张图看懂
你的电脑(本地) → 暂存区(准备区) → 本地仓库(本地存档) → Gitee(远程仓库)
↓ ↓ ↓ ↓
写代码 git add git commit git push
二、第一步:注册 Gitee 账号(5 分钟搞定)
1. 访问官网
打开浏览器,输入:https://gitee.com
2. 点击注册
+--------------------------------+
| 手机号/邮箱/用户名 [输入框] |
| 密码 [输入框] |
| 确认密码 [输入框] |
| [我已同意...] [注册按钮] |
+--------------------------------+
- 用户名:建议用英文 + 数字(比如
zhangsan2024),不要用中文(有些系统不支持);
- 邮箱:用常用邮箱(QQ、163 都行),用来接收验证码;
- 密码:至少 8 位,包含字母和数字。
3. 验证邮箱
- 没收到邮件?→ 检查垃圾箱,或者等 1 分钟再刷新;
- 链接点不开?→ 复制链接到浏览器地址栏打开。
三、第二步:安装 Git(Windows/Mac 详细步骤)
Windows 系统安装
1. 下载安装包
访问:https://git-scm.com/downloads → 点击'Windows'
2. 安装(每一步都要看!)
☑ Git Bash Here ← 必选(命令行工具)
☑ Git GUI Here ← 可选(图形界面)
☑ Associate .git* ... ← 必选(关联文件)
☑ Associate .sh ... ← 可选
Use the Nano editor by default ← 选这个(简单)
(如果你会用 Vim,可以选 Vim)
☑ Git from the command line and also from 3rd-party software
☑ Checkout Windows-style, commit Unix-style line endings
说明:这个配置能避免 Windows 和 Linux 换行符问题
- 全默认,一直点'Next'直到'Install'
- 安装完成后,不要勾选'View Release Notes',直接点'Finish'
3. 验证安装
按 Win+R,输入 cmd 打开命令提示符,输入:
如果显示 git version 2.xx.x,说明安装成功。
Mac 系统安装
方法一:用 Homebrew(推荐)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
方法二:直接下载安装包
- 访问:
https://git-scm.com/download/mac
- 下载
.dmg 文件,双击安装
四、第三步:配置 Git(一次配置,永久使用)
1. 打开 Git Bash(Windows)或终端(Mac)
Windows:在桌面右键,选择'Git Bash Here'Mac:打开'终端'
2. 配置用户名和邮箱(必须!)
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
git config --global user.name "zhangsan"
git config --global user.email "[email protected]"
3. 检查配置
4. 生成 SSH 密钥(连接 Gitee 用)
(1)生成密钥
ssh-keygen -t rsa -C "你的邮箱"
- 按 3 次回车(不用设置密码)
- 看到'The key's randomart image:'表示成功
(2)查看公钥
复制显示的全部内容(从 ssh-rsa 开始到邮箱结束)
(3)添加到 Gitee
- 登录 Gitee → 点击右上角头像 →'设置'
- 左侧'SSH 公钥'
- 粘贴公钥 → 标题随便写(比如'我的电脑')→ 确定
(4)测试连接
看到'Hi XXX! You've successfully authenticated'就成功了。
五、第四步:第一个项目实战(跟着做就会)
场景:你写了一个简单的网页,要传到 Gitee
1. 在电脑上创建项目文件夹
假设你的项目叫 my-first-web,结构如下:
my-first-web/
├── index.html
├── style.css
└── README.md
<!DOCTYPE html>
<html>
<head>
<title>我的第一个网站</title>
<link rel="stylesheet" href="style.css">
</head>
<body>
<h1>欢迎来到我的网站!</h1>
<p>这是我的第一个 Git 项目。</p>
</body>
</html>
body { background-color: #f0f0f0; font-family: Arial, sans-serif; }
h1 { color: #333; }
# 我的第一个网站项目
这是一个学习 Git 和 Gitee 的示例项目。
2. 在 Gitee 上创建仓库
- 登录 Gitee → 点击右上角'+' →'新建仓库'
- 点击'创建'
仓库名称:my-first-web
路径:自动生成(不用改)
介绍:我的第一个 Git 项目
公开:☑ 公开(别人能看到)
☑ 使用 Readme 文件初始化仓库 ← 不勾选(我们自己有)
其他:默认
3. 本地初始化 Git 仓库
打开 Git Bash / 终端,进入项目文件夹:
- Windows:在文件夹里右键'Git Bash Here'
- Mac:终端输入
cd(cd 加空格),把文件夹拖到终端里
看到'Initialized empty Git repository in ...',说明成功。
4. 连接远程仓库
复制 Gitee 仓库的 SSH 地址(在仓库页面点'克隆/下载'→选 SSH):
git@gitee.com:你的用户名/my-first-web.git
5. 第一次提交代码(3 步法)
解释:.表示添加所有文件,也可以指定单个文件 git add index.html
git commit -m "第一次提交:添加网站基础文件"
git push -u origin master
origin:远程仓库的别名(刚才设置的)
master:主分支
-u:第一次推送需要,以后直接 git push
6. 查看成果
六、第五步:日常使用场景(解决实际问题)
学会基础操作后,我们来看实际工作中最常用的几个场景:
场景 1:每天上班第一件事 —— 获取最新代码
cd /path/to/project
git pull origin master
场景 2:修改代码后提交
git status
git add 修改的文件名
git add .
git commit -m "修复了登录 bug"
git push
场景 3:误删文件怎么恢复?
git status
git checkout -- style.css
场景 4:查看历史记录
git log --oneline
git show 提交 ID 的前几位
七、第六步:常见问题解决方案
问题 1:提交时报错'Please tell me who you are'
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
问题 2:推送时报错'failed to push some refs'
git pull origin master
git push origin master
问题 3:输入错提交信息想修改
git commit --amend -m "新的提交信息"
问题 4:不小心提交了不该提交的文件
git rm --cached passwords.txt
git commit -m "移除敏感文件"
git push
八、第七步:进阶技巧(让你更高效)
1. 配置别名 —— 缩短常用命令
alias gs='git status'
alias ga='git add'
alias gc='git commit -m'
alias gp='git push'
alias gl='git log --oneline --graph'
配置后,gs代替 git status,ga .代替 git add .
2. 使用.gitignore文件
创建 .gitignore 文件,列出不想提交的文件:
*.log
node_modules/
.DS_Store
Thumbs.db
3. 分支操作(团队协作必备)
git branch feature-login
git checkout feature-login
git checkout -b feature-login
git checkout master
git merge feature-login
九、学习路线图(从 0 到 1 的路径)
第 1 周:学会基础 - 注册 Gitee - 安装 Git - 第一次提交
第 2 周:熟练日常操作 - 每天练习 git add/commit/push - 学会 git pull 获取更新
第 3 周:解决常见问题 - 处理冲突 - 恢复误删 - 修改提交
第 4 周:参与真实项目 - 加入团队仓库 - 使用分支开发 - 发起合并请求
十、最后的建议
1. 不要怕犯错
- 一天提交 20 次(正常应该几次)
- 提交信息写'又改了'(应该写具体改了啥)
- 把测试代码推到生产(应该用分支)
2. 从小项目开始
不要一开始就在公司项目上练手。用个人小项目(比如这个网页项目)练习,熟练了再应用到工作中。
3. 养成好习惯
- 提交前看状态:
git status 检查要提交的文件
- 提交信息写清楚:不要写'修复 bug',写'修复用户登录时密码验证失败的问题'
- 每天下班前推送:避免代码只存在本地,电脑坏了就没了
写在最后:Git 使用频率统计
git status:20 + 次(随时看状态)
git add:5-10 次(添加修改)
git commit:3-5 次(提交)
git push:3-5 次(推送)
git pull:2-3 次(拉取更新)
这些操作加起来,每天在 Git 上花的时间不超过 30 分钟,但带来的好处是:
- 代码永远不会丢
- 随时能回到任意版本
- 多人协作不会冲突
所以,别被 Git 的'复杂'吓到。就像学骑自行车,一开始会摔,但一旦会了,就再也回不去走路了。
微信扫一扫,关注极客日志
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
相关免费在线工具
- Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
- Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
- Markdown转HTML
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
- HTML转Markdown
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
- JSON 压缩
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
- JSON美化和格式化
将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online