环境准备:工欲善其事,必先利其器
在学习 Python 的过程中,实时记录和备份代码非常重要。GitHub 是代码托管平台,也是学习日志。本文将分享如何将本地代码通过 VS Code 上传到 GitHub,并建立一套清晰的分支管理体系。
一、环境配置
在开始之前,请确保你已经安装了 并在 GitHub 上创建了一个。具体的详细步骤如下:
本文介绍使用 VS Code 和 Git 管理 Python 学习记录的方法。内容包括环境配置(Git 安装、VS Code 扩展、网络代理)、核心操作(仓库初始化、远程关联、提交推送)、分支管理策略及日常同步流程。通过规范化的版本控制,实现代码备份与学习路径的结构化整理。

在学习 Python 的过程中,实时记录和备份代码非常重要。GitHub 是代码托管平台,也是学习日志。本文将分享如何将本地代码通过 VS Code 上传到 GitHub,并建立一套清晰的分支管理体系。
在开始之前,请确保你已经安装了 并在 GitHub 上创建了一个。具体的详细步骤如下:
| 工具名称 | 作用 | 下载地址(建议官网) |
|---|---|---|
| Git | 版本控制核心,负责代码追踪与上传 | git-scm.com |
| VS Code | 常用编辑器,提供可视化 Git 操作 | code.visualstudio.com |
| GitHub 账号 | 云端代码仓库,用于存放与展示学习成果 | github.com |
安装 Git 时,一路点击 Next 即可。安装完成后,需通过终端告知 Git 你的身份:
Win + R 输入 cmd 打开命令行。输入以下命令(替换为你的 GitHub 信息):
git config --global user.name "你的 GitHub 用户名"
git config --global user.email "你的注册邮箱"
验证:输入 git --version 看到版本号即安装成功。
为了让 Git 操作更直观,建议在 VS Code 的扩展商店(Ctrl+Shift+X)安装:
由于 GitHub 服务器在海外,国内访问常有波动。
配置 Git 代理(假设端口为 7890):
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890
git --version 有响应。git config --list 能看到你的用户名和邮箱。总结: 磨刀不误砍柴工,搞定 Git 身份配置与网络代理是后续所有操作不报错的前提,请务必确保 git config 信息准确无误。
当你准备好第一个学习文件夹时,请按照以下精简步骤建立连接。
在 VS Code 终端中进入你的目标文件夹,这是让 Git 开始'监控'文件夹的第一步:
git init.git 文件夹,它是所有版本信息的'黑匣子'。git checkout -b main(直接建立名为 main 的分支,符合现代 GitHub 命名规范)。在 GitHub 创建新仓库后,复制其 HTTPS 链接(如 https://github.com/username/repo.git):
git remote add origin [你的仓库链接]origin,以后上传时就不用输入长长的 URL 了。remote origin already exists,说明之前关联过,可用 git remote rm origin 删除旧关联后再重新添加。这是将文件存入本地'保险箱'的过程:
git add "文件名.md"(如果文件名包含空格,双引号是必须的)。git add *.py(添加所有 Python 文件)或 git add .(添加当前目录下所有改动)。保存快照:git commit -m "feat: 第一次提交学习计划"。
注:
-m后的备注信息建议遵循规范,如feat代表新功能/内容,fix代表修复错误。
最后一步,将本地的'保险箱'同步到 GitHub 云端:
git push -u origin main-u 参数(--set-upstream)非常重要,它能将本地的 main 分支与远程的 main 永久绑定。以后在这个分支上传,只需简单输入 git push 即可。总结: 核心操作的本质是'初始化、建关联、打快照、传云端'四个连贯动作,熟练后这套流程将成为你编程习惯的一部分。
在 Git 的世界里,**分支(Branch)**就像是平行时空。如果你把所有东西都堆在 main 分支,后期查找会非常混乱。通过分支管理,你可以为不同的学习课题(如 Pandas、Matplotlib、爬虫)创建专属空间。
当你开始一个新课题的学习时,不要在 main 分支直接操作,而是创建一个新分支:
git checkout -b learn/pandas-b 代表创建并切换(Create and Switch)。这会瞬间复制当前分支的状态到一个名为 learn/pandas 的新分支中。learn/课题名),这样在工具中查看时会像文件夹一样整齐。在不同的学习任务之间切换,就像换课表一样简单:
git checkout maingit checkout learn/pandasgit branch(带 * 号的就是你目前所在的分支)。本地创建了分支,GitHub 线上也需要对应的备份:
git push -u origin learn/pandaslearn/pandas 的分支。以后你在本地该分支下的所有 push 都会自动飞到这个对应的远程分支里。learn/pandas 分支里怎么写烂代码,都不会影响到 main 分支里的'学习计划表'。main 分支中。总结: 分支管理是 Git 的灵魂,将 main 作为静态门户,将 learn/* 作为动态实验场,能让你的 GitHub 仓库展现出清晰的逻辑架构。
默认情况下,GitHub 可能会把你上传的第一个分支(比如 learn/pandas)设为默认展示页。但作为一个整洁的仓库,我们通常希望别人一进来看到的是 main 分支里的'学习总纲'。
README.md 会被自动显示。git clone 时,系统会自动下载默认分支。main。回到仓库首页(点击仓库名),确认:
main。README.md 已经出现在页面下方。总结: 设置默认分支是提升仓库专业度的最后一步,它确保了你的学习成果能以最有逻辑、最清晰的姿态呈现。
当你完成了环境配置、初始关联和分支设置后,Git 就进入了'维护期'。以后你每天写完代码,不再需要去管那些复杂的配置,只需要像'存进度'一样执行这简单的三步。
在这一步,你告诉 Git 哪些文件是你今天'辛苦劳作'的成果,需要被记录。
git add .+ 号。这是给你的代码'打快照',并写上一条简短的笔记,方便以后查阅。
git commit -m "日期:学习了 Pandas 数据筛选"最后,将本地的所有记录'发射'到 GitHub 云端。
git push如果某天突然报错(如 Connection reset),通常只需检查两点:
git config --global http.proxy。git pull 把云端更新拉下来,再执行 git push。总结: 习惯的力量是巨大的,坚持每天完成'一键三连',你的 GitHub 贡献绿格子将是你学习路径上最闪亮的勋章。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online