【Python】Day24:Git基础与项目准备

🎯 学习目标

1. 理解 版本控制 的意义：记录每次修改，随时回退
2. 掌握Git的三个区域：工作区、暂存区、版本库
3. 掌握常用Git命令：init、add、commit、log、status
4. 学会使用远程仓库：remote、push、clone
5. 为项目搭建好目录结构和 Git 仓库

一、Git

1. Git 是什么?

   Git 是目前最流行的分布式版本控制系统，用于跟踪文件（尤其是代码）的修改历史，并支持多人协作。 简单来说，它可以帮你：记录每次修改：谁、什么时间、改了什么内容，可以随时回到任意历史版本。分支管理：在不影响主代码的情况下，开“分线”开发新功能，测试完成后再合并。团队协作：多人同时修改同一项目，Git 能自动合并大部分改动，或提示冲突让开发者解决。

2. 为什么需要 Git？

   论文_v1.docx论文_v2_修改.docx论文_v3_终稿.docx论文_v4_绝对终稿.docx→ 用 Git 管理后，只需要一个文件，Git 帮你记录每次修改！

3. 三个区域

   工作区（你改代码的地方）git add  → 暂存区（准备提交的修改）git commit  → 版本库（永久保存的历史记录）

二、常用 Git 命令

1. 初始化与提交

   # 初始化仓库，新建一个目录，然后执行命令，将该目录变成一个仓库git init# 查看状态git status# 添加到暂存区git add .               # 添加所有修改git add app.py          # 添加指定文件# 提交到版本库git commit -m "初始化项目"# -m 参数用来描述提交动作，如：“初始化项目”、“修改xx版本的BUG”# 查看历史git log --oneline

2. 远程仓库

   # 关联远程仓库git remote add origin https://github.com/xxx/xxx.git# 推送到远程git push -u origin main# 克隆项目git clone https://github.com/xxx/xxx.git

3. 其他常用命令

   # 查看差异git diff# 回退到上一个版本git reset --hard HEAD^# 拉取远程更新git pull

三、.gitignore 文件

1. 必须忽略的文件

   # .gitignore# 虚拟环境venv/# 环境变量（绝对不能提交！）.env# Python 缓存__pycache__/*.pyc# IDE 配置.vscode/.idea/# 数据和日志*.jsonlapi_log.txt

四、项目目录结构准备

smart_doc_assistant/       # 项目根目录├── .gitignore├── .env                   # API Key 等敏感信息├── requirements.txt       # 依赖列表├── README.md              # 项目说明├── app.py                 # Streamlit 主程序├── api_utils.py           # API 调用工具函数├── file_utils.py          # 文件读取工具函数└── docs/                  # 存放本地文档    └── example.txt        # 示例文档

⚠️ 常见坑

1. 提交了.env文件
• 如果不小心提交了，要立刻更换 API Key！
• 用git rm --cached .env从版本库中删除
2. commit message 不清晰
• ❌ git commit -m "update"
• ✅ git commit -m "feat: 添加文件上传功能"
3. 忘记git add就commit
• 修改文件后必须先add再commit

✍️ 实战练习

1. 初始化项目仓库
• 要求：创建项目目录，初始化 Git，创建.gitignore和基本文件，做第一次提交。
• 示例：

  mkdir smart_doc_assistantcd smart_doc_assistantgit init# 创建 .gitignore, app.py 等文件git add .git commit -m "init: 初始化项目结构"

✅ 自测清单

• [ ] 理解 Git 三个区域：工作区 → 暂存区 → 版本库
• [ ] 能用git add和git commit提交修改
• [ ] 知道.gitignore的作用，必须忽略.env和venv/
• [ ] 能用git push推送到远程仓库
• [ ] 已经为项目搭建好目录结构