# PythonProject

**Repository Path**: sky0535/PythonProject

## Basic Information

- **Project Name**: PythonProject
- **Description**: 《Python编程从入门到实践》第三版电子书和源代码
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-10-21
- **Last Updated**: 2025-12-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python编程从入门到实践, 电子书, 源代码, pdf

## README

# 《Python编程从入门到实践》说明文档

本仓库按书籍《Python编程从入门到实践》（第三版）的章节组织示例代码与阶段性项目，并提供运行与依赖指引。
![《Python编程从入门到实践》封面](./Document/PythonCrashCourse.jpg)

## 目录结构索引（基于当前仓库）
- `Document`：电子书与学习资料（PDF）。
- `Chapter01`：入门示例（如 `hello_world.py`）。
- `Chapter02`：变量、字符串与风格（如 `full_name*.py`、`apostrophe.py`）。
- `Chapter03`：列表基础（如 `bicycles.py`、`cars.py`、`motorcycles.py`）。
- `Chapter04`：列表操作与生成（如 `squares.py`、`square_numbers.py`）。
- `Chapter05`：条件语句与逻辑（如 `voting.py`、`toppings.py`）。
- `Chapter06`：字典与嵌套结构（如 `alien.py`、`pizza.py`、`user.py`）。
- `Chapter07`：输入与循环（如 `greeter.py`、`rollercoaster.py`）。
- `Chapter08`：函数与模块（如 `formatted_name.py`、`printing_models.py`）。
- `Chapter09`：类与继承（如 `dog.py`、`car.py`、`electric_car.py`）。
- `Chapter10`：文件与异常（`exceptions/word_count.py`，含文本数据）。
- `Chapter11`：测试（`test_name_function.py`、`test_survey.py`）。
- `Chapter12`：游戏项目起步与资源（多阶段目录，含 `images/` 与 `ship.py`）。
- `Chapter13`：外星人入侵进阶（含 `alien.py`、`bullet.py`、`settings.py`）。
- `Chapter14`：难度、按钮与记分板（如 `button.py`、`game_stats.py`、`scoreboard.py`、`alien_invasion.py`）。
- `Chapter15`：数据可视化（`random_walks/rw_visual.py`、`rolling_dice/die.py`、`die_visual.py`）。
- `Chapter16`：CSV 与地图（示例结构目录）。
- `Chapter17`：API 与可视化（`python_repos.py`、`python_repos_visual.py`、`hn_article.py`、`hn_submissions.py`）。
- `Chapter18`：Django 项目起步（分阶段目录，含 `manage.py`、`ll_project/`、`learning_logs/`）。
- `Chapter19`：用户账户与认证（阶段目录）。
- `Chapter20`：样式与部署（阶段目录）。

> 注：部分章节包含 `starting_*`、`making_*`、`building_*` 等阶段性子目录；资源目录如 `images/` 与脚本相对路径强相关。

## 环境与依赖（建议）
- Python：`3.10+`（推荐 `3.11/3.12`）。
- 按需安装第三方库：`pygame`、`matplotlib`、`requests`、`plotly`、`django`。
- 虚拟环境（Windows PowerShell）：
  ```powershell
  python -m venv .venv
  .\.venv\Scripts\activate
  pip install -U pip
  pip install pygame matplotlib requests plotly django
  ```

## 运行指南
- 运行基础脚本：
  ```powershell
  python .\Chapter03\bicycles.py
  ```
- 运行带资源的游戏示例（Chapter12–14）：
  - 进入对应阶段目录运行，确保相对路径正确。
  ```powershell
  cd .\Chapter14\scoring
  python alien_invasion.py
  ```
- 运行测试（Chapter11）：
  ```powershell
  python -m unittest discover .\Chapter11
  ```
- 运行数据可视化示例（Chapter15–17）：
  ```powershell
  python .\Chapter15\random_walks\rw_visual.py
  python .\Chapter15\rolling_dice\die_visual.py
  python .\Chapter17\python_repos.py
  ```
- 运行 Django 阶段项目（Chapter18–20）：
  - 在包含 `manage.py` 的阶段目录执行：
  ```powershell
  cd .\Chapter18\starting_an_app
  python manage.py runserver
  ```

## 常见问题
- 资源路径错误：进入脚本所在目录运行；确认当前工作目录与脚本相对路径一致。
- Pygame 窗口问题：更新 `pygame` 与显卡驱动；确保在桌面环境运行。
- 网络与 API：保证联网与可访问性；必要时重试或更换网络。
- 中文路径与编码：若遇编码异常，确保终端与文件使用 UTF-8。
- 安装加速：可使用国内镜像 `-i https://pypi.tuna.tsinghua.edu.cn/simple`。

## 版本控制
- `.gitignore` 已配置，忽略缓存、虚拟环境与 IDE 文件。
- 建议按章节管理提交或标签，便于回溯学习进度。

## 许可与鸣谢
- 代码用于学习与教学；书籍版权归原作者与出版社所有。
- 请勿将资料用于商业再发布。