Python基础学习代码存储与命名规范

来了就未晚2026-08-30 19:11

Python基础 01学习代码存储与命名规范

适用阶段：Python3 基础语法（14天冲刺）

版本：1.0

📁 推荐文件夹结构

在电脑桌面（或任意工作目录）创建主文件夹，例如 python_learning，内部按天组织：

text 复制代码

python_learning/
├── README.md                          # 学习进度总览（打卡表）
│
├── day01_basic_syntax/                # 第1天：基础语法
│   ├── ex1_identifiers_quiz.py
│   ├── ex2_identifiers_fix.py
│   ├── ex3_comments_fill.py
│   ├── ex4_keywords_quiz.py
│   ├── ex5_comments_practice.py
│   ├── ex6_comprehensive.py
│   └── notes.md                       # 当天易错点/心得（可选）
│
├── day02_data_types/                  # 第2天：数据类型
│   └── ...
│
├── day03_strings/                     # 第3天：字符串
│   └── ...
│
├── ...（直至 day14）
│
└── projects/                          # 周末/综合项目单独存放
    ├── guess_number_game.py
    ├── todo_list.py
    └── ...

🏷️ 文件命名规则

格式模板

复制代码

[序号]_[主题关键词]_[简短描述].py

各部分说明

组成部分	含义	示例
序号	练习编号，按当天顺序递增	ex1, ex2, ex3
主题关键词	英文小写+下划线，对应知识点	identifiers, keywords
简短描述	练习类型或功能（可选）	quiz, fix, practice

第1天练习文件命名对照表

原题号	推荐文件名	说明
练习1	ex1_identifiers_quiz.py	标识符判断（选择题）
练习2	ex2_identifiers_fix.py	标识符改错
练习3	ex3_comments_fill.py	注释填空
练习4	ex4_keywords_quiz.py	关键字辨识（选择题）
练习5	ex5_comments_practice.py	添加注释（编程题）
练习6	ex6_comprehensive.py	综合练习（含import）

📄 文件头部元数据模板（建议）

在每个 .py 文件开头添加如下注释块，便于日后检索：

python 复制代码

"""
课程：Python 基础语法 
天数：Day XX
知识点：xxx, xxx
练习目标：xxxxxx
日期：YYYY-MM-DD
"""
# 代码正文从此开始...

📝 README.md 总览模板

在主文件夹下创建 README.md，用于跟踪每日进度。可参考以下结构：

Python 基础学习打卡表

天数	主题	完成状态
Day 01	基础语法（编码、标识符、关键字、注释）	✅
Day 02	数据类型与缩进	⬜
...	...	...
Day 14	项目实战与总结	⬜

每日笔记链接

$Day 01 笔记$ ./day01_basic_syntax/notes.md
...