前言

在学习 Python 的过程中，实时记录和备份代码非常重要。GitHub 不仅仅是一个代码托管平台，更是我们的学习日志。今天分享如何将本地代码通过 VS Code 上传到 GitHub，并建立一套清晰的分支管理体系。

---

一、 环境准备：工欲善其事，必先利其器

在开始之前，请确保你已经安装了 Git 并在 GitHub 上创建了一个新仓库（例如：The-road-to-learning-python）。具体的详细步骤如下：

在开启 GitHub 学习之旅前，需要配置好以下三套核心工具。

1. 软件清单与下载

工具名称	作用	下载地址（建议官网）
Git	版本控制核心，负责代码追踪与上传	git-scm.com
VS Code	宇宙第一编辑器，提供极简的可视化 Git 操作	code.visualstudio.com
GitHub 账号	你的云端代码仓库，用于存放与展示学习成果	github.com

---

2. 环境配置四部曲

第一步：Git 的安装与全局配置

安装 Git 时，一路点击 Next 即可。安装完成后，需通过终端告知 Git 你的身份：

1. 按 Win + R 输入 cmd 打开命令行。

2. 输入以下命令（替换为你的 GitHub 信息）：

   Bash

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

   验证：输入 git --version 看到版本号即安装成功。

第二步：VS Code 扩展增强

为了让 Git 操作更直观，建议在 VS Code 的扩展商店（Ctrl+Shift+X）安装：

• GitLens：可视化代码修改历史。

• GitHub Pull Requests and Issues：直接在编辑器管理 GitHub 任务。

第三步：建立网络“高速通道”（关键）

由于 GitHub 服务器在海外，国内访问常有波动。

1. 开启代理软件：确保你的工具正在运行。

2. 配置 Git 代理（假设端口为 7890）：

   Bash

   git config --global http.proxy http://127.0.0.1:7890
   git config --global https.proxy http://127.0.0.1:7890
   

第四步：完成 VS Code 身份授权

1. 在 VS Code 中点击左下角的 个人账户图标。

2. 选择 Turn on Cloud Changes 或 Sign in to Sync。

3. 在弹出的浏览器页面点击 Authorize。

   这样以后上传代码时，VS Code 就不会再反复找你要账号密码了。

---

3. 环境自测清单

• [ ] 终端输入 git --version 有响应。

• [ ] 终端输入 git config --list 能看到你的用户名和邮箱。

• [ ] 访问 GitHub 官网无需等待太久。                

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

---

二、 核心操作：从本地到云端的“第一次亲密接触”

当你准备好第一个学习文件夹（例如桌面上放着 pandas 笔记的文件夹）时，请按照以下精简步骤建立连接。

1. 仓库初始化 (Initialization)

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

• 指令：git init

• 作用：在当前目录下生成一个隐藏的 .git 文件夹，它是所有版本信息的“黑匣子”。

• 创建主分枝：git checkout -b main（直接建立名为 main 的分支，符合现代 GitHub 命名规范）。

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

在 GitHub 创建新仓库后，复制其 HTTPS 链接（如 https://github.com/vincefeng0709-bot/py.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 找到你的仓库 The-road-to-learning-python，点击顶部最右侧的 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 "2026-01-06: 学习了 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 贡献绿格子（Green Wall）将是你学习路径上最闪亮的勋章。

---

📝 结语 (Closing Remarks)

写在最后：

学习 Git 的过程，其实和学习任何编程语言一样，初看时满是“黑话”和报错，但在一次次 add、commit 和 push 的循环中，你会逐渐理解版本控制的魅力。

这篇总结不仅仅是一份技术指南，它更像是我在 Python 学习之路上的第一座里程碑。通过将代码分支化、文档化，我不仅学会了如何保护自己的劳动成果，更学会了如何结构化地思考与沉淀。

每一个绿色的方块，每一条提交记录，都是我们对抗遗忘、见证成长的证据。代码可能会有 Bug，但前进的脚步从不骗人。

希望这份指南能帮到同样在代码海洋中航行的你。如果遇到报错，别灰心，那正是你即将进步的信号！

---

愿每一行代码都能见证你的成长。 Happy Coding!

---