Gitee 是国内常用的代码托管平台，结合 Git 版本控制系统可有效管理项目历史与协作。本文介绍从零开始配置 Gitee 账号与 Git 环境的方法，涵盖 Windows 与 Mac 系统安装步骤、SSH 密钥生成及仓库连接。通过实战演示首次代码提交流程，包括初始化仓库、添加文件、提交记录及推送到远程。此外还包含日常拉取更新、分支操作、冲突解决及常见问题排查技巧，帮助开发者快速掌握版本管理核心技能，提升协作效率。
三年前，我还在用最原始的方式管理代码：
project_v1_final.zipproject_v1_final_fixed.zipproject_v1_final_fixed_really_final.zip直到有一天，我误删了关键文件，翻遍十几个'final'压缩包也找不回来，才下定决心学 Git。结果一打开教程，满屏的'暂存区'、'远程仓库'、'rebase'——瞬间想放弃。
现在，我每天用 Gitee 管理十几个项目，带的新人也从'完全不懂'到'熟练提交'。今天，我把这套方法完整分享给你。
想象一下：
你的电脑（本地） → 暂存区（准备区） → 本地仓库（本地存档） → Gitee（远程仓库）
↓ ↓ ↓ ↓
写代码 git add git commit git push
打开浏览器，输入：https://gitee.com
你会看到这个页面：
+--------------------------------+
| 手机号/邮箱/用户名 [输入框] |
| 密码 [输入框] |
| 确认密码 [输入框] |
| [我已同意...] [注册按钮] |
+--------------------------------+
填写技巧：
zhangsan2024），不要用中文（有些系统不支持）；注册后，去邮箱找验证邮件，点击链接激活账号。
常见问题：
访问：https://git-scm.com/downloads → 点击'Windows'
双击下载的 .exe 文件，按以下顺序操作：
第一步：许可协议
第二步：安装路径
第三步：选择组件（关键！）
☑ Git Bash Here ← 必选（命令行工具）
☑ Git GUI Here ← 可选（图形界面）
☑ Associate .git* ... ← 必选（关联文件）
☑ Associate .sh ... ← 可选
说明：按上图勾选，点'Next'
第四步：开始菜单文件夹
第五步：选择默认编辑器（重要！）
Use the Nano editor by default ← 选这个（简单）
（如果你会用 Vim，可以选 Vim）
说明：Nano 是最简单的文本编辑器，适合小白
第六步：调整 PATH 环境（最关键的一步！）
☑ Git from the command line and also from 3rd-party software
说明：一定要选这个！否则后面用不了 Git 命令
第七步：选择 HTTPS 传输后端
第八步：配置行尾转换
☑ Checkout Windows-style, commit Unix-style line endings
说明：这个配置能避免 Windows 和 Linux 换行符问题
第九步：配置终端模拟器
☑ Use MinTTY ... ← 选这个
说明：MinTTY 更好用
第十步：其他配置
按 Win+R，输入 cmd 打开命令提示符，输入：
git --version
如果显示 git version 2.xx.x，说明安装成功。
安装 Git：
brew install git
输入命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
https://git-scm.com/download/mac.dmg 文件，双击安装Windows：在桌面右键，选择'Git Bash Here'Mac：打开'终端'
在命令行输入（替换成你的信息）：
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
示例：
git config --global user.name "zhangsan"
git config --global user.email "[email protected]"
输入：
git config --list
应该看到：
user.name=zhangsan
user.email[email protected]
输入：
ssh-keygen -t rsa -C "你的邮箱"
注意：
Windows：
cat ~/.ssh/id_rsa.pub
Mac：
cat ~/.ssh/id_rsa.pub
复制显示的全部内容（从 ssh-rsa 开始到邮箱结束）
输入：
ssh -T [email protected]
看到'Hi XXX! You've successfully authenticated'就成功了。
假设你的项目叫 my-first-web，结构如下：
my-first-web/
├── index.html
├── style.css
└── README.md
文件内容：
index.html：<!DOCTYPE html>
<html>
<head>
<title>我的第一个网站</title>
<link rel="stylesheet" href="style.css">
</head>
<body>
<h1>欢迎来到我的网站！</h1>
<p>这是我的第一个 Git 项目。</p>
</body>
</html>
style.css：body { background-color: #f0f0f0; font-family: Arial, sans-serif; }
h1 { color: #333; }
README.md：# 我的第一个网站项目
这是一个学习 Git 和 Gitee 的示例项目。
填写信息：
仓库名称：my-first-web
路径：自动生成（不用改）
介绍：我的第一个 Git 项目
公开：☑ 公开（别人能看到）
☑ 使用 Readme 文件初始化仓库 ← 不勾选（我们自己有）
其他：默认
打开 Git Bash / 终端，进入项目文件夹：
cd /path/to/my-first-web
注意：怎么找路径？
cd（cd 加空格），把文件夹拖到终端里初始化 Git 仓库：
git init
看到'Initialized empty Git repository in ...'，说明成功。
复制 Gitee 仓库的 SSH 地址（在仓库页面点'克隆/下载'→选 SSH）：
git@gitee.com:你的用户名/my-first-web.git
在命令行输入：
git remote add origin [email protected]:你的用户名/my-first-web.git
这是 Git 最核心的操作，记住这个顺序：
第一步：添加文件到暂存区
git add .
解释：.表示添加所有文件，也可以指定单个文件 git add index.html
第二步：提交到本地仓库
git commit -m "第一次提交：添加网站基础文件"
解释：-m 后面是提交说明，要写清楚做了什么
第三步：推送到 Gitee
git push -u origin master
解释：
origin：远程仓库的别名（刚才设置的）master：主分支-u：第一次推送需要，以后直接 git push刷新 Gitee 仓库页面，你会看到：
恭喜！你已经完成了第一次 Git 提交！
学会基础操作后，我们来看实际工作中最常用的几个场景：
# 进入项目目录
cd /path/to/project
# 拉取最新代码
git pull origin master
# 查看修改了哪些文件
git status
# 添加修改的文件
git add 修改的文件名
# 或者添加所有修改
git add .
# 提交
git commit -m "修复了登录 bug"
# 推送到 Gitee
git push
假设你误删了 style.css：
# 查看删除记录
git status
# 恢复文件
git checkout -- style.css
# 查看简洁版历史
git log --oneline
# 查看某次提交的详细内容
git show 提交 ID 的前几位
原因：没配置用户名和邮箱
解决：
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
原因：远程仓库有本地没有的新内容
解决：
# 先拉取
git pull origin master
# 再推送
git push origin master
# 修改最后一次提交的信息
git commit --amend -m "新的提交信息"
假设你把 passwords.txt 提交了：
# 从 Git 中删除，但保留本地文件
git rm --cached passwords.txt
# 提交这次删除
git commit -m "移除敏感文件"
# 推送到远程
git push
# 添加到~/.bashrc 或~/.bash_profile（Mac）
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 .
.gitignore文件创建 .gitignore 文件，列出不想提交的文件：
# 忽略所有.log 文件
*.log
# 忽略 node_modules 文件夹
node_modules/
# 忽略系统文件
.DS_Store
Thumbs.db
# 创建新分支
git branch feature-login
# 切换到新分支
git checkout feature-login
# 创建并切换（一步完成）
git checkout -b feature-login
# 合并分支到 master
git checkout master
git merge feature-login
第 1 周：学会基础 - 注册 Gitee - 安装 Git - 第一次提交
第 2 周：熟练日常操作 - 每天练习 git add/commit/push - 学会 git pull 获取更新
第 3 周：解决常见问题 - 处理冲突 - 恢复误删 - 修改提交
第 4 周：参与真实项目 - 加入团队仓库 - 使用分支开发 - 发起合并请求
刚开始用 Git 时：
关键：犯错没关系，重要的是学会怎么恢复。
不要一开始就在公司项目上练手。用个人小项目（比如这个网页项目）练习，熟练了再应用到工作中。
git status 检查要提交的文件通常，开发者平均每天：
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 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online