# workbook

**Repository Path**: tinbox/workbook

## Basic Information

- **Project Name**: workbook
- **Description**: C 语言入门习题集（100 道）
本习题集按「基础语法 → 输入输出 → 运算符 → 分支循环 → 数组 → 函数 → 指针 → 结构体 → 文件操作 → 综合练习」梯度设计，覆盖 C 语言入门核心考点。难度分为 ★（基础）、★★（进阶）、★★★（综合），建议零基础学习者循序渐进完成。按照题单原文共整理 11 章、102 题。

- **Primary Language**: C
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-12-15
- **Last Updated**: 2025-12-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# workbook

## 项目简介
C 语言入门习题集（102 题），按照「基础语法 → 输入输出 → 运算符 → 分支循环 → 数组 → 函数 → 指针 → 结构体 → 文件操作 → 综合练习」递进编排，并对题目难度进行 ★/★★/★★★ 分级，便于零基础学习者循序渐进练习。

## 目录结构
```
docs/                    # 题目原文与说明（习题集.md）
exercises/               # 11 个章节，每题一个子目录
	chXX-*/exYY-*/README.md  # 精简题干 + 示例 + 提示
	chXX-*/exYY-*/tests/     # 若题目提供示例则生成 sample.in/out
scripts/
	generate_exercise_readmes.ps1  # 题目 README / 示例生成脚本
README.md               # 当前说明
```

## 使用指南
1. 阅读 [docs/习题集.md](docs/习题集.md) 获取完整题干与背景。
2. 在 `exercises/chXX-*/exYY-*` 目录中打开 README，对照示例数据理解输入输出约束；如需测试数据，可直接使用同级 `tests/` 中的 `sample.in|sample.out`（若存在示例，会自动生成）。更多实践建议见 [docs/学习指南.md](docs/学习指南.md)。
3. 在练习目录中自行创建 `src/`、`build/`、`README.md` 等子目录，使用熟悉的工具链（Visual Studio、VS Code + gcc、CMake 等）实现题目，推荐编译参数：`gcc -std=c11 -Wall -Wextra`。
4. 若题单更新或需重置练习结构，运行脚本生成最新 README/示例：
	 ```powershell
	 # 从仓库根目录执行（已使用相对路径，无需修改）
	 powershell -ExecutionPolicy Bypass -File scripts/generate_exercise_readmes.ps1
	# 仅刷新某一章/单题
	powershell -ExecutionPolicy Bypass -File scripts/generate_exercise_readmes.ps1 -Chapter ch05-loops
	powershell -ExecutionPolicy Bypass -File scripts/generate_exercise_readmes.ps1 -Exercise ex12-sum-odd
	 ```
	 该脚本会根据 `docs/习题集.md` 中的章节配置重新生成所有题目的 README，并在有示例的目录下写入/更新 `tests/sample.*`。

## 后续演进建议
- 持续迭代脚本以支持多语言题面或更多示例用例。
- 为典型题目补充参考解法、测试用例或 CI 编译脚本，方便学习者自检。
- 根据学习反馈扩充 `docs/` 目录，添加调试技巧、常见错误排查等辅导资料。