—— 版本管理·从零到推送上云 ——

每当我开始一个新项目,总忍不住先去想什么"总体规划"。

项目解决什么问题 → 实际使用场景 → 功能列表 → 实现路径……然后就是一顿乱写开发文档,写到后面,自己都看不懂自己写了什么。后续开发就像数学考试不规范作答的答题卡——思维混乱,进度拖沓,非常地一言难尽。

后来我接触到了 GitGitee——一个本地版本管理工具,一个远程代码托管平台。简单来说:Git 帮你记录每次代码改动,Gitee 帮你把代码存到云端。从此再也不用担心改坏代码回不去了。

说实话,我在没正式学编程之前就久闻 GitHub 的大名,但碍于界面全是英文,让我有点转不过来弯。所以先选了国产的 Gitee 入门。下面这篇文章,就以一个新手的视角,把从安装到推代码的全流程走一遍。


壹 · 第一块砖:安装 Git

下载地址:https://git-scm.com/downloads/win

安装时一路 Next 就行,什么都不用改。真的,什么都不用改。

装完后打开 CMD 或 PowerShell,输入:

git --version

看到版本号就说明装好了。如果提示"不是内部命令",那就是没装好,回去检查一下安装路径有没有加到系统环境变量里。


贰 · 第二块砖:注册 Gitee 账号

打开 https://gitee.com 注册一个账号。

注册完后先别急,点右上角头像 → 设置SSH 公钥,先放着,等后面生成了密钥再来填。


叁 · 告诉 Git 你是谁

Git 需要知道你是谁,这样每次提交代码的时候才会带上你的名字和邮箱。打开 PowerShell,执行这两行:

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

执行完验证一下:

git config --global --list

看到你的用户名和邮箱就 OK 了。这一步只需要做一次。


肆 · 第三块砖:SSH 密钥

SSH 密钥的作用是:让 Gitee 知道"这台电脑是我授权过的",这样你推送代码时就不用每次都输密码了。

在 PowerShell 里执行:

ssh-keygen -t ed25519 -C "你注册Gitee的邮箱"

一路按 Enter,三个回车,不要输入任何东西。重要的事情说三遍。

然后执行:

cat ~/.ssh/id_ed25519.pub

会输出一段以 ssh-ed25519 开头的乱码,全选复制它

回到 Gitee → 设置 → SSH 公钥 → 粘贴进去 → 点确定。

验证一下连接:

ssh -T git@gitee.com

看到 Hi xxx! You've successfully authenticated 就成功了。如果报错,检查一下公钥有没有复制完整。


伍 · 创建仓库

登录 Gitee → 点右上角 +新建仓库

仓库名随便取,比如 ai-tarot。其他全部不勾——不要初始化 README、不要 .gitignore。就像搬进一间毛坯房,先别急着买家具。

创建完后会给你一个仓库地址,类似:

git@gitee.com:你的用户名/ai-tarot.git

复制这个地址,下一步要用。


陆 · 把项目推上去

打开 PowerShell,进到你的项目目录:

cd C:\Users\20426\Desktop\ai-tarot

然后依次执行:

# 1. 初始化 Git 仓库(只需要做一次)
git init

# 2. 把所有文件加入"暂存区"
git add .

# 3. 提交,写一句话描述这次改动
git commit -m "V1.0 完整版:命运之轮、AI解读、每日运势、朋友互抽、缘分配对"

# 4. 关联远程仓库(粘贴你刚才复制的地址)
git remote add origin git@gitee.com:你的用户名/ai-tarot.git

# 5. 推送到 Gitee
git push -u origin master

搞定了。去 Gitee 刷新你的仓库页面,所有代码都在上面了。

⚠️ 新手避坑:第一次推送可能会慢一点,耐心等一下。如果报权限错误,回去检查第四步的 SSH 密钥有没有配好。


柒 · 日常使用

每次改完代码想保存,就这么搞。90% 的时间只用这三步:

# 1. 看哪些文件改了
git status

# 2. 全部暂存 + 写一句话
git add .
git commit -m "改了xxx功能"

# 3. 推到云端
git push

就这三步,反复循环。

记住这三行,够你用一年。


捌 · 紧急后悔药

写代码嘛,总会翻车。这几个命令关键时刻能救命:

场景一:改错了,还没提交,想全部撤回。

git checkout .

场景二:提交了但还没 push,想撤回这次提交。

git reset HEAD~1

场景三:push 了但线上炸了,想回到昨天的版本。

git log --oneline          # 找到你要回退的版本号
git reset --hard 那个版本号  # 回退
git push -f                # 强制推送

⚠️ 注意:git push -f 是强制推送,慎用。用了之后别人拉到的代码也会变成你回退后的版本。

场景四:想看看昨天代码长什么样。

git log --oneline          # 找版本号
git checkout 那个版本号      # 切过去看
git checkout master         # 看完切回来

玖 · 写在最后

Git 这东西,刚上手会觉得有一堆命令要记,但真正用起来才发现,日常就那几步。遇到不会的现查也完全来得及。

版本管理这东西,就像给代码买了份保险。你不需要它的时候觉得没必要,但一旦需要的时候——

你会庆幸自己当时学了。

代码的世界比我想象的有意思得多。
而这,才刚刚开始。

写于学习 Git 的第三天


心里有一团火,路过的人只看到烟