前期准备
- 安装 Git:官网下载 Git 并安装,安装完成后,在文件夹右键可以看到
Git Bash Here。 - 注册 Gitee 账号。
- 准备好本地 Python 项目文件夹,里面存放
.py源代码文件。
第一步:在 Gitee 网页新建远程仓库
- 登录 Gitee,点击右上角「+」号 → 新建仓库。
- 仓库名称:英文命名,例如
python-base。 - 仓库简介:python基础知识学习。
- 仓库选择:私有仓库(作业推荐私有,其他人看不到代码)。
- ⚠️重点:不要勾选初始化 README、不要勾选.gitignore,我们本地已有项目,远程仓库保持空仓库。
- 点击创建。
- 创建完成后,复制仓库的 HTTPS 地址,类似:
shturl.cc/09ny1Bmo你的用户名/python-homework.git。
第二步:本地 Git 操作(核心命令)
进入你的 Python 项目文件夹,空白处右键,打开Git Bash Here。
首次使用 Git,配置用户名和邮箱(只需要配置一次)
git config --global user.name "你的Gitee用户名" git config --global user.email "你的Gitee注册邮箱"2. 初始化本地 Git 仓库
git init执行完成后,文件夹会生成隐藏.git文件夹,代表本地仓库创建成功。
3. 将项目文件加入暂存区
git add .注意:末尾有一个英文句号
.,代表把当前目录下所有文件加入暂存区。 如果只想上传单个 py 文件:git add test.py
4. 提交到本地仓库,添加提交备注
git commit -m "第一次提交:Python课程作业代码"引号内写本次提交说明,写清楚本次修改内容,课程作业建议规范填写。
5. 关联本地仓库和 Gitee 远程仓库
把刚才复制的 Gitee 仓库地址粘贴进去
git remote add origin shturl.cc/09ny1Bmo你的用户名/python-homework.git如果提示
origin already exists,说明之前关联过远程地址,执行:git remote set-url origin shturl.cc/09ny1Bmo你的用户名/python-homework.git
6. 推送到 Gitee 远程云端仓库
新版 Gitee 默认分支是 main,如果 master 报错,换成:
git push -u origin main
第一次推送会弹出登录窗口,输入 Gitee 账号密码,等待推送完成。
五、验证上传成功
打开 Gitee 仓库网页,刷新页面,就可以看到本地的 Python 代码文件已经上传到云端仓库。 以后修改本地代码、提交新作业,只需要重复执行:
git add . git commit -m "第二次提交:xx作业更新" git push六、新手常见问题
- 中文路径报错:文件夹名称全部改成英文。
- push 失败,提示权限不足:确认仓库地址正确,HTTPS 方式登录时 Gitee 账号密码无误。
- 不想上传的文件(缓存、pyc 文件):新建
.gitignore文件,写入__pycache__/,Git 会自动忽略这类文件。
# .gitignore示例 __pycache__/ *.pyc七、总结
本次实验学会了 Git 的基础工作流:git init初始化仓库、git add加入暂存区、git commit本地提交、git remote关联远程仓库、git push推送到 Gitee。 后续所有 Python 课程作业,都通过这套流程提交代码,方便老师查看代码版本,也锻炼版本控制能力。
git push -u origin master后续上传项目出现空项目情况,可进入你的 Python 项目文件夹,空白处右键,打开Git Bash Here。输入以下代码解决。
通过本次实验,我第一次完整地使用 Git 工具将本地 Python 项目上传到 Gitee 远程仓库,真切体会到版本控制工具的作用。以前写代码只是单纯保存文件,修改多了就会出现代码v1.py、代码v2.py这类杂乱的文件,一旦误删或者改错,很难找回之前的版本。而 Git 可以记录每一次提交的改动,随时查看历史版本,这对项目开发来说非常实用。
在操作过程中,我也遇到了不少小问题。一开始不清楚各个 Git 命令的含义,混淆了暂存区、本地仓库和远程仓库的概念,推送代码的时候还出现过分支名不匹配的报错。经过反复核对命令,一步步排查,最终成功把代码上传到 Gitee,让我理解了 Git 工作流程:工作区→暂存区→本地仓库→远程仓库。
同时我也认识到规范提交的重要性,每次commit时写清晰的备注,可以方便自己和他人看懂每一次代码修改的内容。老师要求后续作业都使用 Gitee 提交代码,不再直接上交文件,这种方式更贴近真实软件开发的工作模式。
这次学习不仅掌握了 Git 与 Gitee 的基础操作,也培养了良好的代码管理习惯。后续写 Python 作业时,我会坚持使用 Git 管理代码,熟悉版本控制,为之后更大的项目开发打好基础。