# python

**Repository Path**: tju2019/python

## Basic Information

- **Project Name**: python
- **Description**: python
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 8
- **Forks**: 1
- **Created**: 2025-03-02
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pydemo — Python 教学讲义与示例代码

本项目包含《Python 程序设计及应用》课程的教学讲义与配套示例代码，供学生下载学习使用。

## 目录结构

```
pydemo/
├── Python教程/          # 课程讲义（Markdown 格式）
│   ├── assets/          # 讲义中的图片等资源文件
│   ├── 01 Python 简介.MD
│   ├── 02 Python 安装和程序运行.MD
│   ├── 03 Python 编程基础.MD
│   ├── 04-01 变量与赋值.MD
│   ├── 04-02 数字类型和运算.MD
│   ├── ...              # （共 60+ 个章节讲义）
│   └── 13-05 数据转换.MD
│
├── sample/              # 各章节配套示例代码
│   ├── ch08/            # 第 08 章：包与模块
│   │   ├── 01/
│   │   ├── 02/
│   │   │   ├── sample01_module_import/
│   │   │   ├── sample02_custom_module/
│   │   │   ├── sample03_math_package/
│   │   │   ├── sample06_date_utils/
│   │   │   └── sample07_exercise/
│   │   └── ...
│   └── ch09/            # 第 09 章：文件读写
│       ├── sample01_read_write/
│       ├── sample02_with_statement/
│       ├── sample03_csv/
│       ├── sample04_path_ops/
│       ├── sample05_dir_ops/
│       └── sample06_exercise/
│
└── README.md            # 本文件
```

## 使用说明

1. **讲义阅读**：进入 `Python教程/` 目录，按章节顺序阅读 `.MD` 文件。建议在 VS Code 中使用 `Ctrl+Shift+V` 预览 Markdown。
2. **示例运行**：进入 `sample/` 下对应章节的目录，直接运行 `.py` 文件即可。
3. **数据文件**：部分示例代码目录下包含课程中使用的数据文件（CSV、Excel 等）。

## 章节对应

| 章节 | 讲义文件 | 示例代码 |
|------|----------|----------|
| 08 包与模块 | `08-00 包与模块.MD` | `sample/ch08/` |
| 09 文件读写 | `09 文件读写.MD` | `sample/ch09/` |

> 其他章节的示例代码会陆续补充。

## 环境要求

- Python 3.10+
- 部分示例需要安装第三方库（如 numpy、pandas、matplotlib），详见各章节讲义。

## 下载并在 PyCharm 中打开项目（ZIP 方式）

如果你不熟悉 Git，可以使用下面最基础的方法把项目下载到本地并在 PyCharm 中打开：

### 第一步：下载项目 ZIP 包

1. 打开浏览器，进入本项目的 GitHub（或 Gitee）页面。
2. 点击页面右上角的绿色 **「Code」** 按钮。
3. 在弹出的菜单中选择 **「Download ZIP」**。
4. 浏览器会自动下载一个名为 `pydemo-main.zip`（或类似名称）的压缩包，记住它的保存位置（通常在「下载」文件夹中）。

### 第二步：解压 ZIP 包

1. 找到刚才下载的 ZIP 文件。
2. **Windows**：右键点击 ZIP 文件 → 选择 **「全部解压缩...」**（或「解压到当前文件夹」）。
3. **Mac**：双击 ZIP 文件即可自动解压。
4. 解压后会得到一个文件夹，例如 `pydemo-main/`。你可以把它重命名为 `pydemo/`，然后放到你想存放项目的位置（比如桌面或文档文件夹）。

### 第三步：在 PyCharm 中打开项目

1. 打开 **PyCharm**。
2. 点击左上角菜单栏的 **「文件(File)」 → 「打开(Open)」**（或者欢迎界面直接点击 **「Open」**）。
3. 在弹出的文件浏览器中，找到并选中你刚才解压出来的项目文件夹（例如 `pydemo-main` 或 `pydemo`）。
4. 点击 **「确定(OK)」** 按钮。
5. PyCharm 会自动加载项目。第一次打开时，它可能会提示你配置 Python 解释器：
   - 点击右下角（或右上角）的 **「配置 Python 解释器」** 提示。
   - 选择你已安装的 Python 版本（如 Python 3.12）。
   - 如果没有安装 Python，请先安装 Python 后再配置。

### 第四步：运行示例代码

1. 在 PyCharm 左侧的「项目」面板中，展开 `sample/ch08/` 或 `sample/ch09/` 目录。
2. 双击打开任意一个 `.py` 文件（例如 `main.py`）。
3. 在代码编辑区空白处 **右键单击** → 选择 **「运行 'main'」**（或按快捷键 `Ctrl + Shift + F10`）。
4. 运行结果会显示在底部的「运行」窗口中。