(一)为一份能运行的程序保存版本
1. 从阅读统计程序开始
把配套 starter 文件夹复制到自己新建的 reading-git 目录,后面的本地练习在这份副本中进行。reading.py 沿用前文的达标判断:
# 项目文件:starter/reading.py
# 不少于目标分钟数记为达标;导入模块时不执行演示输出。
def count_met(minutes: list[int], goal: int) -> int:
return sum(value >= goal for value in minutes)
if __name__ == "__main__":
print(count_met([20, 35, 45], 35))# 项目文件:starter/check_reading.py
# 这些小检查只使用标准 Python;完整 pytest 项目仍可沿用第六章。
from reading import count_met
assert count_met([20, 35, 45], 35) == 2
assert count_met([35], 35) == 1
assert count_met([], 35) == 0
print("阅读统计检查通过")README 中先保留一处待修正的说明,让后面能看到一次真实差异:
<!-- 项目文件:starter/README.md -->
# 阅读统计
项目用途:阅读练习。
默认目标:30 分钟。
运行程序:python reading.py
运行检查:python check_reading.py程序使用 35,说明却写成 30。先保存当前程序,再把这处文档修改单独提交,历史就能解释“改了什么”和“为什么改”。
2. 本地记录与远程托管各自负责的动作
Git 在本机管理文件快照、提交关系和分支;GitHub 托管远程仓库,并提供 Issue、Pull Request、代码审查和自动检查。VS Code 通过本机 Git 提供图形操作,登录 GitHub 则用于访问对应的远程资源。
在编辑器按 Ctrl+S,把文本写进工作目录;运行 git add,选择下一次提交的内容;运行 git commit,在本地仓库中建立提交;运行 git push,才把对应提交发送到远程。关闭网络后仍可在本地查看历史、建立分支和提交。