120 lines
4.0 KiB
Markdown
120 lines
4.0 KiB
Markdown
---
|
|
doc_type: short
|
|
full_text: sources/00_Setup.md
|
|
---
|
|
|
|
# 00_Setup 总结
|
|
|
|
## 核心内容
|
|
|
|
本文是 Practical Python Programming 课程的设置与概览说明，主要介绍课程所需时间、Python 环境要求、仓库准备方式、目录结构、学习顺序以及解答代码的使用建议。
|
|
|
|
## 课程时长与投入
|
|
|
|
- 课程最初设计为 3 到 4 天的线下面授培训。
|
|
- 若完整学习，建议至少投入 25–35 小时。
|
|
- 不直接查看解答代码会更有挑战，但也更有助于掌握内容。
|
|
|
|
## Python 环境要求
|
|
|
|
课程只需要基础的 Python 3.6 或更新版本：
|
|
|
|
- 不依赖特定操作系统。
|
|
- 不要求特定编辑器或 IDE。
|
|
- 不需要额外 Python 工具链。
|
|
- 课程主体不依赖第三方包；第 9 章会出于教学目的演示如何在虚拟环境中安装第三方包，例如 `pandas`。
|
|
|
|
原课程要求 Python 3.6 或更新版本。以当前实践看，建议使用仍受官方维护的 Python 3.x 版本，并按本机平台选择合适安装包。
|
|
|
|
课程重点是编写脚本和小程序，尤其是处理文件中的数据。因此，学习者需要能方便地：
|
|
|
|
- 使用编辑器创建 Python 程序；
|
|
- 在 shell 或终端中运行程序；
|
|
- 读写并管理本地文件。
|
|
|
|
## 不建议使用 Jupyter Notebook
|
|
|
|
文中特别强调不建议使用 Jupyter Notebook 完成本课程。原因是课程不仅关注代码实验，还强调 Python 程序组织，包括：
|
|
|
|
- 函数；
|
|
- 模块；
|
|
- import 语句；
|
|
- 多文件源代码；
|
|
- 代码重构。
|
|
|
|
这些内容更适合在真实文件系统、编辑器和终端环境中练习，而不是在交互式 Notebook 中完成。
|
|
|
|
## 课程仓库准备
|
|
|
|
推荐学习者 fork 官方 GitHub 仓库：
|
|
|
|
- 官方仓库：https://github.com/dabeaz-course/practical-python
|
|
|
|
然后克隆到本地：
|
|
|
|
```bash
|
|
git clone https://github.com/yourname/practical-python
|
|
cd practical-python
|
|
```
|
|
|
|
如果不想 fork 或没有 GitHub 账号，也可以直接克隆官方仓库：
|
|
|
|
```bash
|
|
git clone https://github.com/dabeaz-course/practical-python
|
|
cd practical-python
|
|
```
|
|
|
|
fork 的好处是可以将自己的解答代码提交回个人仓库，形成完整的学习记录；直接克隆则只能在本地保存修改。
|
|
|
|
这一部分与 Git 与课程仓库管理 相关。
|
|
|
|
## 课程目录结构
|
|
|
|
所有编码工作都应在 `Work/` 目录中完成。
|
|
|
|
其中：
|
|
|
|
- `Work/`：学习者编写程序和完成练习的主要目录；
|
|
- `Work/Data/`：包含课程中使用的数据文件和相关脚本；
|
|
- `Solutions/`：包含部分练习的完整解答代码。
|
|
|
|
课程练习默认学习者在 `Work/` 目录中创建和运行程序，并经常访问 `Data/` 中的数据文件。这与 Python 文件处理 和 [[concepts/课程练习工作流]] 相关。
|
|
|
|
## 学习顺序
|
|
|
|
课程材料应按章节顺序完成，从第 1 章开始。
|
|
|
|
原因是后续章节会建立在前面章节写出的代码之上，许多后续练习会要求对已有代码进行小幅重构。因此，跳过前面内容可能会影响后续练习的连续性。
|
|
|
|
## 解答代码使用建议
|
|
|
|
`Solutions/` 目录提供了部分练习的完整解答。文档建议：
|
|
|
|
- 可以在需要提示时查看；
|
|
- 但为了获得最佳学习效果，应先尝试自己完成解答；
|
|
- 解答代码更适合作为参考，而不是直接复制。
|
|
|
|
## 关键观点
|
|
|
|
1. 本课程强调真实脚本开发环境，而不是纯交互式实验。
|
|
2. 学习者应熟悉编辑器、终端、文件系统和 Git 仓库的基本使用。
|
|
3. 所有练习应集中在 `Work/` 目录中完成，以符合课程假设。
|
|
4. 后续课程会持续复用和重构前面写过的代码，因此学习顺序很重要。
|
|
5. 解答代码可作为提示，但独立实现更有助于学习。
|
|
|
|
## 可延伸概念
|
|
|
|
- Python 程序组织
|
|
- Python 文件处理
|
|
- Git 与课程仓库管理
|
|
- [[concepts/课程练习工作流]]
|
|
|
|
## Related Concepts
|
|
- [[concepts/Git-与课程仓库管理]]
|
|
- [[concepts/Python-开发环境]]
|
|
- [[concepts/模块与-import]]
|
|
- [[concepts/文件读写]]
|
|
- [[concepts/main-函数与脚本结构]]
|
|
- [[concepts/函数]]
|
|
- [[concepts/包与虚拟环境]]
|