简介：猜数字游戏是C语言入门阶段的经典实战项目，这份资料面向正在学习C/C++基础语法、或想通过小项目巩固编程能力的初学者，也适用于课程作业与教学演示场景，提供两个不同版本的完整源程序。压缩包共2个文件，均为.cpp源代码，资源包总大小仅3KB，内容精简，便于直接阅读和对比两个版本的写法差异。已有410人学习浏览，说明该案例作为编程练习具备一定参考价值。两版代码可对照分析，覆盖随机数生成（rand/srand）、条件分支、循环控制、标准输入输出与函数封装等核心知识点，能直观看到作者在变量声明、错误处理和代码注释上的迭代思路。在此基础上，还可尝试限制猜测次数、添加计时器等扩展功能，既可以快速巩固语法基础，也能熟悉标准库函数与程序结构化设计的综合运用，是一份轻量但完整的C语言实践素材。
1. 猜数字：C语言初学者最该亲手写完的第一个完整程序
学 C 语言时，猜数字几乎是每个人都会遇到的一道程序题：程序在 1 到 100 之间藏一个随机数，你每输入一个数字，它就用“大了”或“小了”给你反馈，直到猜中为止。规则看着简单，但它把变量、循环、分支、随机数、标准输入输出这些 C 语言的核心语法一次性串了起来。对于刚学完语法、想练手的新手来说，它是一个能立刻看到反馈的完整项目；对于想复习 C 语言的老手来说，它又是一份浓缩了基本控制流与输入校验思路的代码样本。我拆完这套“c语言 之 猜数字 源程序”之后发现，它的价值不在“猜数字”本身，而在于随机数种子、缓冲区清理、循环退出这几个最容易翻车的点全都得亲手处理一遍，适合拿来直接编译运行，也适合照着改造。
2. 程序设计拆解：从游戏规则到代码结构的选型逻辑
2.1 游戏规则与状态转换：先画流程再写代码
猜数字的逻辑用一句话就能说清：在区间内生成目标数，循环接收玩家猜测，比较后给出“大了/小了”的提示，猜中则退出。这句话翻译成代码之前，我建议先把它拆成几个状态，因为初学者最容易卡住的往往不是语法，而是“下一步该干什么”。拆开之后是这样的：初始化状态，目标是生成随机数并把范围告诉玩家；等待输入状态，读取玩家输入并做合法性检查；比较状态，判断当前数字和答案的大小关系；结束状态，猜中后跳出循环并输出猜测次数。
这段流程对应到 C 语言里，最自然的写法是 do-while 循环：玩家至少要尝试一次，无论猜得对不对，先进入循环体，再判断是否继续。很多人习惯用 while(1) 配 break，功能上完全没问题，但 do-while 在语义上更贴合“先执行一次，再判断是否重复”的场景。本节先把这个状态模型讲清楚，后面 2.4 再深入对比两种循环写法的取舍。
如果你画流程图，会发现这个游戏没有复杂的并发和状态记忆，用一组变量就能表达全部状态：target 保存答案，guess 保存当前输入，count 记录有效次数。这也是为什么猜数字适合做第一个完整程序——它小到能看清全局，又大到需要处理输入异常。另外，画流程图时把图里的分支和代码里的 if-else 一一对应起来，能避免很多“只可意会不可言传”的逻辑漏洞。比如输入合法性检查在流程图上就应该画在“读取输入”和“比较大小”之间，对应代码里就是 scanf 之后的 if 判断。这一步做扎实了，后面写代码基本就是翻译。
2.2 随机数生成：rand 与 srand 的配合及种子陷阱
随机数是猜数字的题眼。C 标准库提供的 rand() 返回一个介于 0 和 RAND_MAX 之间的伪随机整数，RAND_MAX 定义在 stdlib.h 里，具体数值取决于编译器实现，通常是一个比较大的正整数。要得到 1 到 100 之间的数字，常见做法是取模后加偏移：rand() % 100 + 1。这里的 % 100 把结果映射到 0 到 99，+1 再平移到 1 到 100。
但 rand() 生成的是固定伪随机序列，如果不做初始化，每次程序运行得到的序列完全一致。也就是说，第一次运行的答案是 42，第二次运行答案还是 42，游戏从一开始就失去了意义。解决方法是在生成随机数之前调用 srand() 设置随机种子，最常用的种子来源是当前时间：
#include <stdio.h> #include <stdlib.h> #include <time.h> int main(void) { srand((unsigned)time(NULL)); int target = rand() % 100 + 1; printf("已经想好了一个 1 到 100 之间的数字。\n"); return 0; }time(NULL) 返回从标准时间起点到当前时刻经过的秒数，每次运行通常不同，适合当种子。注意这里要强制转成 unsigned，因为 srand 的形参类型是 unsigned int，直接传 time_t 类型在某些编译器的告警选项下会提示类型不匹配。还有一个非常隐蔽的坑：如果两次运行间隔不足 1 秒，time(NULL) 可能返回同一个值，导致连续启动程序得到相同序列。调试时遇到“答案和上次一模一样”，先怀疑这里，而不是怀疑 rand 本身。
关于取模的均匀性，严格来说，如果 RAND_MAX 不能被 100 整除，取模会让部分余数出现的概率略高于其他余数。但对猜数字这种游戏场景，用户完全感知不到这种偏差，不必过度优化。如果实在在意，可以用 rand() / (RAND_MAX / 100 + 1) 做缩放，但这不是这份源码要解决的问题。
srand 的参数也有讲究：直接把 time(NULL) 强转成 unsigned 是常见写法，编译器会先警告 time_t 转 unsigned int 可能截断，加上 (unsigned) 就是把“我明确知道这里要转换”的意图告诉编译器。在 64 位平台上 time_t 是 64 位，转成 32 位 unsigned 会截断，但对种子来说，取低位时间值已经足够。
2.3 输入与比较：scanf、getchar 与缓冲区清空策略
猜数字里最影响体验的是输入环节。scanf("%d", &guess) 是读取整数的经典写法，但它有一个初学者经常忽略的返回值：成功读取时返回 1，读取失败时返回 0。如果玩家手滑输入了字母或小数，scanf 并不会自动跳过非法字符，而是读取失败，并把非法字符留在输入缓冲区里。下一次 scanf 再读，还是会撞见同样的字符，于是程序反复提示“请输入数字”，形成死循环。
我习惯在读取后立刻检查返回值，失败时用 getchar 清空缓冲区：
int guess; printf("请输入你的猜测："); if (scanf("%d", &guess) != 1) { while (getchar() != '\n'); printf("输入无效，请输入一个整数。\n"); continue; }while (getchar() != '\n') 的作用是逐个读取缓冲区里的字符，直到把换行符也读掉。玩家输入 abc 时，缓冲区里是 a、b、c、换行四个字符，getchar 会在循环里依次把它们消费掉，缓冲区恢复干净，下一轮 scanf 才能正常工作。getchar() 每次只读一个字符，所以必须用循环，不能只写一次。
还有一个容易漏掉的变体：玩家输入 12abc，scanf 会成功读到 12，把 abc 留在缓冲区。下一轮如果玩家输入 34，scanf 先读到的还是 abc，直接失败。因此只要某轮出现过非法输入，都建议清理缓冲区，不能因为这次 scanf 返回值是 1 就放松警惕。当然，更彻底的做法是用 fgets 读整行再解析，但在这份源码里，scanf + 清缓冲已经能覆盖绝大多数使用场景。
2.4 循环结构选型：while(1) + break 与 do-while 的取舍
猜数字的主循环有两种常见写法。第一种是 while(1) 配合 break：
while (1) { printf("请输入你的猜测："); if (scanf("%d", &guess) != 1) { while (getchar() != '\n'); continue; } if (guess == target) { break; } else if (guess > target) { printf("大了！\n"); } else { printf("小了！\n"); } }第二种是 do-while：
do { printf("请输入你的猜测："); if (scanf("%d", &guess) != 1) { while (getchar() != '\n'); continue; } if (guess > target) { printf("大了！\n"); } else if (guess < target) { printf("小了！\n"); } } while (guess != target);两种写法都能跑，但适用场景有区别。while(1) + break 的优点是把退出时机完全交给 break，想在哪一行退出就在哪一行写，非常灵活；缺点是循环条件不明显，读代码的人需要到处找 break 才能确认退出路径，条件一多逻辑就容易散。do-while 的优点是把“没猜中就继续”这个条件集中在循环末尾，读起来一目了然，猜中后条件不成立自然退出，不需要专门写 break；缺点是如果循环体中间有 continue，它会跳过循环体剩余部分直接去判断条件，处理不好会绕晕。
最终源码里我用的是 do-while 配合一个 break：主路径用 do-while 表达“没猜中就继续”，遇非法输入用 continue 回到输入步骤，猜中时用 break 提前退出。组合起来可读性最好，也顺带解决了 if-else 嵌套过深的问题。你完全可以用 while(1) 版本，两者编译后的机器码差异可以忽略，这个选择纯粹是代码风格问题。
3. 完整源码与逐段拆解：一份能直接编译运行的猜数字程序
3.1 完整源码：单文件实现
把前面讨论的随机数初始化、输入校验、循环结构合在一起，就是一份完整的单文件 C 程序。它不依赖任何第三方库，所需的头文件都是标准库：
#include <stdio.h> #include <stdlib.h> #include <time.h> #define MIN_VALUE 1 #define MAX_VALUE 100 int main(void) { int target, guess, count = 0; srand((unsigned)time(NULL)); target = rand() % (MAX_VALUE - MIN_VALUE + 1) + MIN_VALUE; printf("猜数字游戏：数字在 %d 到 %d 之间。\n", MIN_VALUE, MAX_VALUE); do { printf("请输入你的猜测："); if (scanf("%d", &guess) != 1) { while (getchar() != '\n'); printf("输入无效，请输入一个整数。\n"); continue; } count++; if (guess < MIN_VALUE || guess > MAX_VALUE) { printf("数字超出范围，请重新输入 %d 到 %d 之间的数字。\n", MIN_VALUE, MAX_VALUE); count--; continue; } if (guess > target) { printf("大了！\n"); } else if (guess < target) { printf("小了！\n"); } else { printf("恭喜你，猜中了！你一共猜了 %d 次。\n", count); break; } } while (1); return 0; }这段代码重点解决了三个问题：随机数每次启动都不同、非法输入不会导致死循环、猜中后能正常统计并退出。游戏范围被设计成 MIN_VALUE 和 MAX_VALUE 两个宏，想改难度只需要改这两个值，游戏逻辑本身不用动。
特别注意 count-- 那行。玩家输入越界数字时 count 已经提前加一，如果不在越界分支里减回去，最后统计的猜测次数会比实际有效次数多。这个细节不写出来，程序也能跑，但结果不准确，属于“隐藏正确性问题”。把它放在这里，就是为了让 count 只统计真正有效的猜测。
3.2 逐段拆解与关键参数说明
先看头文件。stdio.h 提供 printf、scanf、getchar，stdlib.h 提供 rand、srand，time.h 提供 time。三者缺一不可：漏掉 stdlib.h，rand 和 srand 没有声明，编译器会警告隐式声明；漏掉 time.h，time 函数没有声明，编译阶段同样会卡。
再看宏定义。MIN_VALUE 和 MAX_VALUE 规定了数字范围，也直接参与生成公式。这里用宏而不是普通变量的原因是：宏在预处理阶段完成文本替换，不占用运行时内存，也不会被意外修改；想调整难度时，只需要改编译前的两行，整个程序的行为都会跟着变。
主函数里声明了三个 int 变量。target 是程序生成的答案，guess 是玩家每次输入的值，count 是有效猜测次数。int 在常规 32 位或 64 位平台上能表示 -2147483648 到 2147483647 的整数，放 1 到 100 的数字绰绰有余。有同学喜欢用 unsigned int 来“更省空间”，其实这里没有负数需求，但 int 是最自然的选择，不需要刻意改用无符号类型。
生成目标数这一行值得展开：
target = rand() % (MAX_VALUE - MIN_VALUE + 1) + MIN_VALUE;MAX_VALUE - MIN_VALUE + 1 是区间长度，100 减 1 加 1 等于 100，所以 rand() % 100 得到 0 到 99，加上 MIN_VALUE 得到 1 到 100。如果想把范围改成 10 到 50，宏定义改成 MIN_VALUE 10、MAX_VALUE 50，公式自动算出区间长度 41，结果落在 10 到 50，不需要额外修改取模逻辑。这里最容易算错的是“上限减下限要不要加一”，结论是要加，否则永远取不到最大值。
比较分支用的是三层 if-else。有人可能会问：为什么不先判断大小、再判断猜中？因为猜中必须单独统计次数并退出，把它放在最后会让代码多一层嵌套，不如直接用 guess > target、guess < target、else 三种情况平铺，最后一种自然就猜中了。
参数汇总如下：
| 名称 | 类型 | 作用 | 典型值 | | target | int | 保存程序生成的答案 | 1 到 100 之间 | | guess | int | 玩家本轮输入的数字 | 任意整数 | | count | int | 有效猜测次数 | 从 0 开始累加 | | MIN_VALUE | 宏 | 数字范围下限 | 1 | | MAX_VALUE | 宏 | 数字范围上限 | 100 |
3.3 编译与运行：gcc 命令与常用告警选项
拿到源码后第一件事是编译。我这边用的是 gcc，命令如下：
gcc -Wall -Wextra -o guess_number guess_number.c-Wall 和 -Wextra 是告警选项，能提示未使用变量、类型不匹配、隐式声明这类潜在问题。平时跑着没问题，不代表代码没问题，开着告警能帮你提前发现很多隐患。-o guess_number 指定输出文件名，不写的话默认生成 a.out（Windows 平台是 a.exe）。编译成功后运行：
./guess_numbergcc 生成的 Linux 可执行文件默认带可执行权限，不需要额外 chmod。如果你在 Windows 命令行里编译，输出是 guess_number.exe，直接输入文件名运行即可。整个过程不依赖第三方库，有 C 编译器的机器都能跑。
如果你用的是集成开发环境，可以不敲命令，把源码保存为 .c 文件后直接编译运行。但 IDE 默认未必打开 -Wall -Wextra 对应的告警级别，建议到项目设置里找到“附加选项”或“编译器选项”，手动加上这两个开关。很多看起来“莫名其妙”的运行时问题，其实在编译阶段就留下了线索。有时候编译报错说 implicit declaration of function 'srand'，先检查是不是漏了 #include <stdlib.h>。在 C99 之后，隐式声明本身就是错误，不只是告警，所以头文件一个都不能少。
3.4 调整难度：通过宏定义控制数字范围
这份源码最顺手的地方是难度可调。想改成 1 到 1000 的版本，只需要改两行：
#define MIN_VALUE 1 #define MAX_VALUE 1000重新编译后，取模公式会自动适配新区间，其他代码完全不用动。这就是把常量抽成宏的好处：游戏逻辑和具体数字范围解耦，以后想换玩法，比如 50 到 500，也能在一分钟内搞定。
如果想让游戏更有挑战性，可以进一步限制猜测次数。常见做法是引入 MAX_TRIES 宏，在 count 达到上限时打印失败提示并退出。这会牵动主循环的结构，所以我把它留到第 5 章的进阶版本一起处理。先把基础版本跑通，确认行为符合预期，再逐步加功能，是比一口气写完更稳的节奏。改完宏之后建议重新做一次边界测试，比如把 MAX_VALUE 改成 1000 后，故意输入 1000，确认答案范围确实覆盖新上限。
4. 排查与避坑：猜数字程序最容易翻车的五个现场
版本能跑通只是第一步。我在实际讲解、演示和帮别人调代码的过程中，见过这五个问题反反复复出现，每一个都有人花半小时以上排查。它们有一个共同特点：代码能编译、能运行，只是在某个输入或某个时刻突然翻车。下面按“现象 → 原因 → 解决”的顺序写清楚。
4.1 每次运行随机数都一样：忘了设置随机种子
现象：程序编译运行了许多次，每次答案都一样，甚至重启电脑后还是那个数字。很多人会怀疑是“随机数玄学”，其实答案就藏在代码里。
原因：只调用了 rand() 却没有调用 srand()。rand() 默认使用一个固定的初始种子，生成的是同一段伪随机序列，每次程序运行都从同一个位置开始，结果自然一样。
解决：在 main 开头、生成 target 之前调用 srand((unsigned)time(NULL))，让种子随当前时间变化。注意只在程序开始时调用一次，不要放在循环内部。如果设置后答案仍然重复，检查一下两次运行间隔是否小于 1 秒，time(NULL) 的精度是秒，间隔太短时种子相同，答案相同是正常现象，停半秒再运行就能看到变化。
补充一个快速验证方法：在测试阶段临时加一行 printf("target=%d\n", target);，连续运行几次，观察输出是否每次都不同。验证完再删掉这行。如果发现连续几次的 target 呈递增趋势，那说明种子确实来自时间戳，程序逻辑本身没有错。
4.2 输入字母后程序死循环：scanf 失败与缓冲区残留
现象：玩家输入 abc，程序不停地输出“请输入你的猜测”，或者反复提示输入无效，敲任何内容都没有反应，只能强制关闭窗口。
原因：scanf("%d") 遇到非数字字符时读取失败，但失败的原因和残留数据都没有被处理。非法字符留在输入缓冲区里，下一次 scanf 又读同一段数据，还是失败，于是死循环。很多老教材里写过的 fflush(stdin) 不是标准行为，在多数现代编译器上根本清不掉缓冲区。
解决：检查 scanf 的返回值，失败时用 while (getchar() != '\n'); 循环消费缓冲区残留。注意这个动作必须发生在 continue 之前，否则会跳过清理逻辑。核心代码如下：
if (scanf("%d", &guess) != 1) { while (getchar() != '\n'); continue; }这里还有一个变体：玩家输入 12abc，scanf 会成功读取 12，abc 留在缓冲区。下一轮玩家输入 34，scanf 先读到 abc，一样失败。所以只要前后行为异常，优先怀疑缓冲区里有上一轮残留，把清理逻辑放在整个输入流程的入口处最保险。
4.3 猜中了程序不退出：break 的位置被 continue 截断
现象：屏幕已经打印“恭喜你，猜中了”，但循环没有结束，马上又开始下一轮“请输入你的猜测”，玩家必须再输入一次才会退出。
原因：break 写错了位置，最常见的是写在了 continue 之后。continue 会立刻把控制流送回循环判断处，break 根本没机会执行；或者 break 写在 if 外面，被其他分支绕了过去。还有一种情况是把 do-while 的循环条件倒着写，比如 while (guess == target)，猜中后条件为真，反而继续循环。
解决：在猜中的分支里，先打印结果，再写 break，并保证 break 是当前分支最后一条语句。do-while 的循环条件保持 while (1)，让退出完全交给 break，逻辑更直接。写完代码后做一个边界测试：第一轮直接输入 target 的边界值，或者临时把 target 打印出来再输入正确答案，确认程序能退出。这个测试每次都做，比事后排查快得多。
4.4 范围边界算错：rand() % 100 与 rand() % 100 + 1 的差别
现象：程序提示“数字在 1 到 100 之间”，但实际答案可能是 0，或者永远猜不出 100。
原因：生成公式写成了 rand() % 100，它产生 0 到 99，没有平移到 1 开头。正确写法是 rand() % 100 + 1。如果最小值不是 1，比如 50 到 100，要写成 rand() % (100 - 50 + 1) + 50。这里的 +1 代表区间长度，漏掉它，上限 100 永远不会出现。
解决：把范围定义成宏之后，统一用 3.1 节的公式计算。调试时连续运行十几次，在测试代码里打印每次的 target，观察最小值和最大值是否符合预期。> 提示：随机数边界问题不会每次必现，可能跑很多次才出现一次，不要因为“试了几次没问题”就跳过检查。我一般会在写完公式后用一组极端值手动推算一遍，代入最小值和最大值，确认结果落在期望区间内，再进入正式测试。
4.5 把 srand 放进循环：每次猜测都重置随机序列
现象：程序能运行，但答案似乎总在几个固定数字之间来回跳；或者退出后立刻重启程序，答案和上一次一样。
原因：srand 被误放在 do-while 循环内部，每猜一次就重置一次随机序列。由于 time(NULL) 在秒级精度下短时间内可能返回相同值，连续重置后 rand() 会从同一个起点重新生成序列，导致本应随机的答案变成可预测的固定循环。
解决：srand 只调用一次，放在 main 函数开头，生成 target 之前。记住 rand 负责生成序列，srand 只负责初始化序列，二者是“一次初始化、多次生成”的关系。看代码时只要发现 srand 出现在循环体内，基本就是 bug，直接挪到 main 开头即可。
另一个容易混淆的点是：生成 target 之后不要再调用 srand，否则下一次 rand() 会重新开始，target 的生成序列也被打乱。随机种子设置得越早越简单，放在头几行就不会错。检查代码时可以从 main 第一行往下扫，确认 srand 排在所有 rand 调用之前，而且只出现一次。
5. 进阶玩法：把猜数字封装成带难度分级的小游戏框架
5.1 把游戏核心封装成函数
基础版本的所有逻辑都堆在 main 里，功能没问题，但想加难度分级和历史记录时，代码会迅速膨胀。我一般会把最核心的两个能力抽成函数。第一个是生成目标数：
int generate_target(int min, int max) { return rand() % (max - min + 1) + min; }第二个是读取合法整数。输入校验逻辑很独立，而且以后写其他 C 程序也能复用。函数内部处理 scanf 失败、缓冲区清理、范围检查，只把合法数字返回给调用方。主循环里就不用再写一堆 getchar 逻辑，读起来清爽很多。函数命名上注意别和宏混用：宏名通常全大写，比如 MIN_VALUE，参数名用小写 min、max，C 语言是严格区分大小写的，这样不会撞名，读起来也清楚。
5.2 增加难度分级与结果统计
实际演示时，我建议在此基础上做三个难度：简单 1 到 50，普通 1 到 100，困难 1 到 200。用 switch 根据玩家选择设置 min 和 max，再进入游戏循环。游戏结束后，把本轮次数和理论最优次数比较，理论最优次数可以用 log2(max-min+1) 向上取整估算，猜得比它快就额外给一句鼓励。
想再往前一步，可以把每轮成绩写入文本文件，用 fopen、fprintf、fclose 实现持久化，下次启动显示历史最好成绩。一个容易混淆的细节是：写文件用的是 fprintf(fp, "%d\n", count)，第一个参数是文件流指针；如果顺手写成 printf，那只会打到控制台，文件里什么都没留下。用 fopen 打开文件后记得检查返回值，文件创建失败时返回 NULL，不检查的话后续写操作会直接崩溃。
自从某次演示时我忘了检查 scanf 返回值，当着几个人的面把程序跑进死循环之后，我每次写带输入的 C 程序都会强制走一遍排查清单：srand 有没有初始化、scanf 返回值有没有检查、缓冲区有没有清理、break 是否放在正确的分支里。这套习惯就是从猜数字这个程序养成的。希望帮到你。
本文还有配套的精品资源，点击获取
