🚀 Git + GitHub + VSCode 零基础保姆级入队指南
引言:AI编程的救命稻草——Git
同学,你可能在想:“git是什么 我们是写代码的 为什么要安装这个东西?”
回答:因为我们是AI编程,AI有时候“发神经”会把你的项目改的丑不拉几 无法运行 改的地方太多了又不好撤回 这是我的真实经历 :
真实故事:我之前用Trae AI改代码,优化我们的问卷网页的时候。我一次性巴拉巴拉输出了5个需求。测试一下这个的能力上限。
我当时兴冲冲地打开网页,结果网页不仅丑不拉几还突然运行不了了,气死我了。我当时还手贱在编辑器里想修改一下,然后还点击了确认。无敌了
幸好我之前听了ai的建议先装了Git,一条命令把代码恢复到之前正常的状态。如果没有Git,我们这个项目可能原地解散了哈哈
这就是Git的作用:代码的“时光机”和“后悔药”。
Git vs GitHub:它们是什么关系?
| 工具 | 是什么? | 作用 | 类比 |
|---|---|---|---|
| Git | 版本控制软件(融合到你的命令行里面去) | 记录每次代码修改,可以随时回到你提交过的历史版本 | 就像玩游戏的“存档”一样,这个档打废了可以读档 |
| GitHub | 代码托管平台(网站,免费的代码云端存储库) | 1. 备份你的代码到云端,永不丢失 2. 多人协作,合并代码 3. 展示你的项目(简历里放个项目那不是nb?(doge)) | 就像代码的“网盘+朋友圈” |
核心比喻:
- Git = 你电脑上的“存档软件”(想要存档的时候3行命令就行了)
- GitHub = 把“存档”过的记录上传到云端(备份+协作)
为什么必须用?
- 防AI发神经:AI改代码把项目改坏了,一键恢复
- 防手残:自己改错了,一键恢复
- 团队协作:四个人同时改代码,自动合并,不会互相覆盖
- 代码备份:电脑坏了、丢了,代码都在云端
第一章:注册GitHub账号(电脑版全流程)
1.1 为什么先注册GitHub?
因为我们要把代码存到云端,需要先有个账户。GitHub是全球最大的代码托管平台,也是程序员的“社交网络”。
1.2 注册步骤(每个步骤都需要截图!)
步骤1:打开GitHub官网(需要梯子 然后最好有一个翻译的插件 外国网站 除非你的英文特别好 不然还是翻译一下 这是我用的 edge插件商店里搜一下就行了)
- 网址:
https://github.com把你的邮箱填进去(常用的 qq邮箱就行)
步骤2:点击“Sign up后填写信息”
- 【配图2】点击后的注册页面截图
点击“Create account”
tips:用户名不要太抽象哈哈 Hr可能会看 ✔️ 接收产品更新(可选) 步骤3:人机验证 6道变态的人机验证题目(我的是连线题目)
然后github会给你的邮箱发一个验证码 填入就行了 进入你的邮箱
步骤4:完成注册
重要提示:
- ✅ 注册后立即登录一次,确认成功
- ✅ 把用户名和密码记在手机备忘录
- ✅ 队友间互相加好友(后面教)
第二章:安装Git(Windows/Mac双版本)
2.1 安装Git的目的
Git是运行在你电脑上的“命令行存档软件”,只有安装了Git,才能使用GitHub的云端功能。
2.2 Windows用户安装步骤
步骤1:下载Git
- 网址:
https://git-scm.com/download/win就这第一个 看你电脑 一般都是x64 最新版的
步骤2:运行安装程序
步骤3:选择安装位置
- 默认C盘即可,点Next
步骤4:选择组件()
这个也默认就行
步骤5:其他设置
- 一路Next,都用默认设置
- 最后点Install
步骤6:验证安装
-
按
Win + R,输入cmd回车 -
输入
git --version(注意有个空格) -
看到版本号就成功了!
第四章:连接Git和GitHub(关键!)
4.1 配置Git用户信息(一次性)
- 打开终端(Windows用CMD)(vscode里面的终端也行)
- 输入以下两行命令(绿色的字替换成你的信息):
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"
(两行分开输入 不然就会报错
git只认识一行命令)
4.2 给Git 挂载代理
【原因】git 默认不会走梯子 得告诉他走这个梯子
- 动作:在终端输入以下命令(告诉 Git 走 7890 通道): 【端口就是梯子配置的端口 默认都是7890】
git config --global http.proxy http://127.0.0.1:7890
第五章:可以部署一个的github的项目
5.1 这是我们团队的做的一个问卷网站的项目 你们可以尝试部署这个作为练习
网址:
https://github.com/hhh-dahah/CyberTCM.git
5.2 克隆项目到本地
步骤1:选择存放位置
- 建议放桌面或D盘,路径不要有中文
步骤2:用VS Code克隆
-
打开VS Code
-
按
Ctrl+Shift+P -
输入“Git: Clone”
-
粘贴项目地址 (我上面给的网址)
-
选择存放文件夹
步骤3:打开项目
- 克隆完成后,VS Code会提示打开
- 点击“Open”
第六章:运行项目(验证一切正常)
6.1 第一次运行前检查
检查1:文件夹结构
- 左边栏应该看到这些文件:
CyberTCM/
├── app.py
├── requirements.txt
├── assets/
└── ...
检查2:打开终端
- VS Code顶部菜单:查看 → 终端
- 确认路径正确(结尾是
/CyberTCM>)
6.2 安装Python依赖
pip install -r requirements.txt
- 我把依赖全部写在requirement 这个文件里了所以直接运行这个命令就行了
我这已经安装过了(安装过程开梯子 不然很慢)
6.3 运行项目
-命令行输入
streamlit run app.py
-如果没有自动打开网页就按住ctrl 鼠标点一下下面那个Local URL就可以打开网页 就这样 (评论区截图交作业啊hh)
第七章:日常协作流程(简化版SOP)
7.1 每天开始工作前
# 1. 拉取最新代码(同步队友的修改)
git pull origin master
# 2. 运行项目
streamlit run app.py
7.2 写完代码后保存
# 1. 添加所有修改
git add . 【注意后面有个空格和一个点】
# 2. 写提交信息(必须!)
git commit -m "你的名字: 做了什么"
# 示例:git commit -m "张三: 修复了登录按钮bug"
# 3. 推送到GitHub 【开梯子】
git push origin master
7.3 记住这3个命令就够用
每天开始:git pull
修改后:git add . → git commit -m "描述" → git push
第八章:常见问题解决(Q&A)
Q1:命令输错了怎么办?
A:按Ctrl+C可以中断当前命令。
Q2:终端显示一堆看不懂的英文?
A:直接复制问ai 让它解决
第九章:团队验收任务清单
每个队员完成以下任务后在群里打卡:
✅ 任务清单
- 注册GitHub账号,把用户名发群里
- 安装VS Code,截图主界面
- 克隆项目,截图文件结构
- 运行项目,截图浏览器打开的网页
🏆 完成奖励
- 全队完成:请我喝奶茶
- 前三名完成:给我发红包
- 帮助队友解决问题:团队贡献加分
第十章:下一步学习计划
完成这个指南后,我们按这个顺序学习:
学习路线图
graph LR
A[Git基础] --> B[Trae熟练使用]
B --> C[Docker环境统一]
C --> D[Docker环境统一]
D --> F[项目部署上线]
预计时间
- 本周:完成Git基础(这个指南)
- 下周:项目开发规范
- 下下周:Docker入门
- 一个月后:我们的AI项目中级版完成!
遇到任何问题,随时在群里@我,或者直接打我的电话。
记住:我们是一个团队,你的问题就是团队的问题。没有人会笑你问“蠢问题”,因为每个人都是从零开始的。
现在,开始第一步吧!从打开github.com开始。
📎 附录:所有链接汇总
必备网站
- GitHub注册:
https://github.com - Git下载:
https://git-scm.com/downloads - VS Code下载:
https://code.visualstudio.com
团队资源
- 项目地址:
https://github.com/hhh-dahah/CyberTCM.git