使用 VS Code + Git 高效管理 Python 学习记录

3. 环境自测清单

• 终端输入 git --version 有响应。
• 终端输入 git config --list 能看到你的用户名和邮箱。
• 访问 GitHub 官网无需等待太久。

总结： 磨刀不误砍柴工，搞定 Git 身份配置与网络代理是后续所有操作不报错的前提，请务必确保 git config 信息准确无误。

二、核心操作：从本地到云端的连接

当你准备好第一个学习文件夹时，请按照以下精简步骤建立连接。

1. 仓库初始化 (Initialization)

在 VS Code 终端中进入你的目标文件夹，这是让 Git 开始'监控'文件夹的第一步：

• 指令：git init
• 作用：在当前目录下生成一个隐藏的 .git 文件夹，它是所有版本信息的'黑匣子'。
• 创建主分枝：git checkout -b main（直接建立名为 main 的分支，符合现代 GitHub 命名规范）。

2. 远程仓库关联 (Remote Linking)

在 GitHub 创建新仓库后，复制其 HTTPS 链接（如 https://github.com/username/repo.git）：

• 指令：git remote add origin [你的仓库链接]
• 作用：给远程地址起个别名叫 origin，以后上传时就不用输入长长的 URL 了。
• 避坑指南：如果提示 remote origin already exists，说明之前关联过，可用 git remote rm origin 删除旧关联后再重新添加。

3. 文件的精准上传 (Add & Commit)

这是将文件存入本地'保险箱'的过程：

• 精准添加：git add "文件名.md"（如果文件名包含空格，双引号是必须的）。
• 通配符添加：git add *.py（添加所有 Python 文件）或 git add .（添加当前目录下所有改动）。

保存快照：git commit -m "feat: 第一次提交学习计划"。

注：-m 后的备注信息建议遵循规范，如 feat 代表新功能/内容，fix 代表修复错误。

4. 首次推送 (Push)

最后一步，将本地的'保险箱'同步到 GitHub 云端：

• 指令：git push -u origin main
• 关键点：-u 参数（--set-upstream）非常重要，它能将本地的 main 分支与远程的 main 永久绑定。以后在这个分支上传，只需简单输入 git push 即可。

总结： 核心操作的本质是'初始化、建关联、打快照、传云端'四个连贯动作，熟练后这套流程将成为你编程习惯的一部分。

三、分支化管理：像专业开发者一样整理学习路径

在 Git 的世界里，**分支（Branch）**就像是平行时空。如果你把所有东西都堆在 main 分支，后期查找会非常混乱。通过分支管理，你可以为不同的学习课题（如 Pandas、Matplotlib、爬虫）创建专属空间。

1. 创建学科专属分支 (Branch Creation)

当你开始一个新课题的学习时，不要在 main 分支直接操作，而是创建一个新分支：

• 指令：git checkout -b learn/pandas
• 作用：-b 代表创建并切换（Create and Switch）。这会瞬间复制当前分支的状态到一个名为 learn/pandas 的新分支中。
• 命名建议：使用斜杠命名法（如 learn/课题名），这样在工具中查看时会像文件夹一样整齐。

2. 分支间的自由穿梭 (Switching)

在不同的学习任务之间切换，就像换课表一样简单：

• 切换到主页：git checkout main
• 切回学习笔记：git checkout learn/pandas
• 查看当前位置：git branch（带 * 号的就是你目前所在的分支）。

3. 将本地分支同步到云端 (Remote Branching)

本地创建了分支，GitHub 线上也需要对应的备份：

• 指令：git push -u origin learn/pandas
• 效果：这会在远程仓库也创建一个名为 learn/pandas 的分支。以后你在本地该分支下的所有 push 都会自动飞到这个对应的远程分支里。

4. 为什么要这么做？（专业优势）

• 隔离风险：你在 learn/pandas 分支里怎么写烂代码，都不会影响到 main 分支里的'学习计划表'。
• 结构清晰：在 GitHub 网页端，点击分支下拉菜单，可以看到你的学习进度被清晰地分类。
• 合并灵活：等你某天觉得 Pandas 学得差不多了，可以再考虑把它的精华部分合并（Merge）到 main 分支中。

总结： 分支管理是 Git 的灵魂，将 main 作为静态门户，将 learn/* 作为动态实验场，能让你的 GitHub 仓库展现出清晰的逻辑架构。

四、默认分支设置：打造你的 GitHub 个人主页

默认情况下，GitHub 可能会把你上传的第一个分支（比如 learn/pandas）设为默认展示页。但作为一个整洁的仓库，我们通常希望别人一进来看到的是 main 分支里的'学习总纲'。

1. 为什么要设置默认分支？

• 第一印象：默认分支的内容会直接渲染在仓库首页。
• 文档展示：只有默认分支下的 README.md 会被自动显示。
• 克隆便捷：当别人（或你在另一台电脑上）执行 git clone 时，系统会自动下载默认分支。

2. 详细设置步骤（GitHub 网页端）

1. 进入仓库设置：打开浏览器，登录 GitHub 找到你的仓库，点击顶部最右侧的 Settings（齿轮图标）。
2. 定位分支选项：在左侧侧边栏中，点击 Branches（通常在第三或第四项）。
3. 切换默认分支：在右侧的 Default branch 区域，点击那个带有'双箭头'的切换图标。
4. 选择并确认：
   • 在下拉列表中选择 main。
   • 点击 Update。
   • 在弹出的红色警告框中，点击 I understand, update the default branch。

3. 设置成功后的验证

回到仓库首页（点击仓库名），确认：

• 左上角的分支显示器默认显示为 main。
• 你之前上传的'学习计划表'或 README.md 已经出现在页面下方。

总结： 设置默认分支是提升仓库专业度的最后一步，它确保了你的学习成果能以最有逻辑、最清晰的姿态呈现。

五、日常同步：每天学习后的'一键三连'

当你完成了环境配置、初始关联和分支设置后，Git 就进入了'维护期'。以后你每天写完代码，不再需要去管那些复杂的配置，只需要像'存进度'一样执行这简单的三步。

1. 暂存更改 (Stage)

在这一步，你告诉 Git 哪些文件是你今天'辛苦劳作'的成果，需要被记录。

• 指令：git add .
• VS Code 快捷操作：点击左侧'源代码管理'图标，在 Changes 栏目右侧点击 + 号。
• 作用：将所有修改过的文件放入'待提交清单'。

2. 提交备注 (Commit)

这是给你的代码'打快照'，并写上一条简短的笔记，方便以后查阅。

• 指令：git commit -m "日期：学习了 Pandas 数据筛选"
• VS Code 快捷操作：在 Message 框输入文字，点击蓝色的 Commit 按钮。
• 建议：养成带日期的习惯，这会让你在回顾时有极强的成就感。

3. 一键同步 (Push)

最后，将本地的所有记录'发射'到 GitHub 云端。

• 指令：git push
• VS Code 快捷操作：点击底部的 Sync Changes 或蓝色的 Publish 按钮。
• 作用：确保你的代码在云端也有备份，即便电脑坏了，学习记录也不会丢失。

避坑小贴士：如果 Push 失败了怎么办？

如果某天突然报错（如 Connection reset），通常只需检查两点：

1. 检查代理：确认你的代理软件是否开启，是否需要重新运行第二模块提到的 git config --global http.proxy。
2. 先拉后推 (Pull before Push)：如果你在 GitHub 网页端手动修改过文件（如改了 README），记得先执行 git pull 把云端更新拉下来，再执行 git push。

总结： 习惯的力量是巨大的，坚持每天完成'一键三连'，你的 GitHub 贡献绿格子将是你学习路径上最闪亮的勋章。