去年我带几个学过C基础的新手朋友做练习项目。计算器、图书管理系统这类题目做完的感觉就是会了但没完全会离真正的工程实践始终隔着一层。直到我把当年火出圈的Wordle改造成命令行版本他们才第一次体验到设计数据结构→实现规则→处理边界情况→打磨交互的完整链路。这个项目非常适合C入门之后、想通过动手巩固知识的人。它不依赖任何第三方库只用标准库就能写完覆盖了类设计、容器使用、随机数、输入输出控制、字符编码处理等高频知识点。同时规则足够简单——每次猜一个词得到三种颜色反馈最多猜6次——实现起来却有不少值得琢磨的细节。这篇文章会从规则梳理讲到完整源码再分享我在不同系统上编译运行踩过的坑以及后续可以扩展的方向。1. 为什么选Wordle作为C练手项目它比练习题更像真实工程1.1 一个练手项目应该满足什么条件我衡量一个练手项目值不值得做主要看三点。第一点是规则明确但不过于庞大。Wordle的规则可以在两三句话内说清楚但实现时要处理字母重复出现这种边界情况不会让人觉得无从下手也不会简单到没有思考量。第二点是能覆盖多种C核心语法。如果项目只用到cout和if做完基本没收获。Wordle需要你设计类来封装状态需要用vector保存多轮猜测记录需要unordered_map统计字母频次需要随机数从词库选答案还需要在输入输出上做精细控制。第三点是结果直观、有反馈感。命令行程序最难的就是反馈感但Wordle天然有颜色反馈和逐行显示的历史记录每次猜测都能立刻看到结果这种即时反馈对学习动力很有帮助。第三点我认为在练习中最容易被忽略。传统习题做完只有编译通过Wordle却能做出真正可以拿给别人玩、甚至骗到同事说你在终端里做wordle的小工具。1.2 这个项目覆盖的知识点清单如果把这个项目拆分一下每个模块对应的C知识点大致是这样的类与封装用一个WordleGame类管理答案、历史记录、当前输入标准容器std::vector存储历史结果std::unordered_map统计字母出现次数随机数std::mt19937和std::uniform_int_distribution从词库挑选答案文件操作从外部词库读取所有合法单词宽字符处理支持中文词库时必须用std::wstring和std::wcout程序流程控制游戏主循环、输入校验、胜负判定对初学者来说这恰好串起了一整条知识链。很多人学完STL容器后不知道什么时候该用哪个做完这个项目vector和unordered_map的适用场景基本就清楚了。1.3 和教材练习项目的本质差异这里的差异值得展开说一说。教材里的练习题通常把函数接口都给你定好了你只需要填空。而Wordle从零开始一切都要自己设计。比如每一次猜测的反馈结果用什么数据结构存放这个问题教材不会帮你回答你必须自己想清楚。选择vectorLetterResult还是二维数组取决于你要不要支持动态的猜词次数每个格子要不要保存字符和颜色状态取决于渲染时是否需要重绘历史记录。另外练习题往往有一个隐藏前提输入总是合法的。但真实程序必须考虑用户输入了一个不在词库里的词怎么办。这种防御性编程思维才是工程实践和习题之间最大的差别。2. 动手之前先理清规则状态机、判定逻辑与重复字母这个隐藏坑2.1 从官方规则到程序状态机写代码之前我习惯先画一遍逻辑流程图——不是要画给谁看而是为了逼自己把所有路径想清楚。Wordle的程序流程是这样的从词库随机选一个目标单词答案玩家输入一个猜测校验猜测是否合法长度正确、在词库中逐字母判定颜色绿色字母在答案中且位置正确黄色字母在答案中但位置不对灰色字母不在答案中如果全部绿色玩家胜利如果猜测次数耗尽显示答案玩家失败否则回到第2步这个流程对应到代码里就是一个主循环核心状态只有当前行号和游戏是否结束。真正的复杂点在步骤4——判定逻辑不能想当然地写。下面专门讲这个。2.2 三个颜色反馈的判定为什么不能直接双重循环很多人第一反应是对每个猜测字母遍历答案看它在不在、位置对不对。直接双重循环就会踩坑。我举个例子。假设答案是APPLE玩家输入PIPES。直观处理方式第一个P在答案中存在但位置不同 → 黄色第二个字母I不在答案中 → 灰色第三个字母P呢答案里只有一个P但第一个P已经占用了这个名额所以第三个P应该判灰色如果双重循环不加控制第三个P会因为答案中存在P而被标成黄色这就不对了。Wordle的官方规则是黄色标记不能超过答案中该字母的总次数。正确的做法分两遍处理。第一遍先标记所有绿色匹配同时记录答案中每个字母还剩余多少次可匹配机会。第二遍处理剩下的位置只有字母存在且剩余次数大于0才标黄色每次标记后把计数减一。这样每个字母的消耗都被精确追踪不会出现上面那种一个字母被重复计数的问题。这个地方是整个游戏算法的题眼写代码时值得单独抽出一个小函数来测试。我在调试时专门写了几组用例比如答案SPEED猜SEEKS、答案ABBEY猜BABES逼着程序处理重复字母的边界。2.3 键盘反馈与胜负条件除了每行的格子反馈Wordle还有一个键盘状态条记录每个字母目前被判定过的最高优先级颜色方便玩家排除字母。这里的优先级是绿色 黄色 灰色。实现时可以用一个std::mapwchar_t, MatchType来保存每次新判定结果产生后如果当前字母还没有记录或新的优先级更高就更新。胜负条件本身不复杂任意一行全绿就是胜利行数达到上限还没有全绿就是失败。但这里有一个容易被忽略的设计问题——玩家输入的词不在词库里怎么办。我做的处理是不消耗猜测次数直接提示不在词库中让玩家重新输入。这样玩家可以试探一些乱七八糟的组合而不受惩罚更接近官方体验。3. 模块边界与技术选型从能跑到好维护的工程化思路3.1 文件划分与类设计虽然项目规模不大我还是建议至少分成main.cpp、WordleGame.h、WordleGame.cpp三个文件。原因是强迫自己区分声明和定义感受头文件在编译流程中的作用。很多初学者在单个文件里写习惯了到多文件工程就懵用这个小项目过渡正好。WordleGame类的职责我控制在三块负责一局游戏的全部状态答案、最大猜测次数、历史记录、当前输入、键盘状态核心逻辑方法evaluate判定颜色、isValid校验输入、render绘制面板不负责的事情词库的加载解析单独放在loadWords函数里和游戏类解耦为什么把词库加载放外面因为加载词库和游戏逻辑是两件不同的事。词库可能来自文件也可能未来来自网络、来自数据库不该被绑定在游戏类里。接口层面WordleGame只接收一个std::vectorstd::wstring它对词库的来源一无所知。这就是依赖倒置的一个简单实践虽然讲得深了没必要但代码自然形成了这个结构。3.2 词库文件的组织方式词库文件我采用每行一个单词的纯文本格式。英文词库就放全小写的5字母单词中文词库就放5个汉字组成的词。为什么每行一个因为解析简单也方便人工维护和审查。如果担心词库太大加载慢后续可以改成二进制格式或哈希表快照但对这个小项目来说文本格式完全够用。词库文件还承担了一个隐藏作用输入校验。玩家猜的词必须在词库中就存在这是Wordle的规则之一。所以词库既是答案池也是合法输入的白名单。项目里我会内置一个words.txt如果用户没提供词库文件就使用代码内置的一组单词作为兜底。这样保证任何环境下载下来都能运行不会因为缺文件而劝退。3.3 颜色渲染方案ANSI转义序列与跨平台处理命令行显示颜色标准做法是ANSI转义序列。形如\033[背景色m的字符会被终端解释为颜色切换。绿色背景是\033[48;5;28m黄色背景是\033[48;5;220m灰色背景是\033[48;5;240m结束恢复默认是\033[0m。这种方案的坑在于Windows的经典控制台conhost旧版本默认不解释ANSI转义需要手动启用虚拟终端处理。还好Windows 10以上的新终端基本都默认支持如果遇到老环境可以通过设置控制台模式来开启。我用一个小的封装接口来处理#ifdef _WIN32 #include windows.h void enableVirtualTerminal() { HANDLE hOut GetStdHandle(STD_OUTPUT_HANDLE); DWORD mode 0; GetConsoleMode(hOut, mode); SetConsoleMode(hOut, mode | ENABLE_VIRTUAL_TERMINAL_PROCESSING); } #endifmacOS和Linux终端天然支持完全不需处理。所以跨平台代码里这个函数只对Windows有条件编译。4. 源码拆解核心数据结构、判定函数与游戏主循环4.1 项目文件总览我实际跑通的项目文件结构是wordle-cli/ ├── main.cpp ├── WordleGame.h ├── WordleGame.cpp ├── words.txt └── CMakeLists.txt其中main.cpp负责入口逻辑启用控制台特性、加载词库、创建WordleGame对象并循环进行多局游戏。下面先看WordleGame.h的完整声明。// WordleGame.h #pragma once #include string #include vector #include map #include unordered_map enum class MatchType { EXACT, // 绿色位置和字母都正确 EXISTS, // 黄色字母在答案中但位置不对 NONE // 灰色字母不在答案中 }; struct LetterResult { wchar_t ch; MatchType type; }; class WordleGame { public: WordleGame(std::vectorstd::wstring words, int maxGuesses 6); void run(); private: std::vectorstd::wstring m_words; std::wstring m_answer; int m_maxGuesses; int m_currentRow 0; std::wstring m_currentInput; std::vectorstd::vectorLetterResult m_history; std::mapwchar_t, MatchType m_keyState; std::vectorLetterResult evaluate(const std::wstring guess) const; void updateKeyState(const std::vectorLetterResult row); void render() const; bool isValidWord(const std::wstring word) const; void resetGame(); };m_currentRow记录当前正在填写的行号m_history保存之后所有判定过的行m_currentInput保存玩家正在输入但还没提交的字母m_keyState用于键盘状态条。4.2 main函数与多局游戏循环main.cpp里除了加载词库还负责让玩家可以玩完一局再来一局// main.cpp #include iostream #include fstream #include string #include vector #include random #include WordleGame.h #ifdef _WIN32 #include windows.h #endif static std::vectorstd::wstring loadWordsFromFile(const std::string path) { std::vectorstd::wstring result; std::wifstream fin(path, std::ios::binary); if (!fin) return result; fin.imbue(std::locale(en_US.UTF-8)); // 视操作系统和编译器调整 std::wstring line; while (std::getline(fin, line)) { // 去除行尾的 \rWindows文本文件和首尾空白 while (!line.empty() (line.back() L\r || line.back() L )) line.pop_back(); if (line.size() 5) result.push_back(line); } return result; } int main() { #ifdef _WIN32 SetConsoleOutputCP(CP_UTF8); // 确保中文正常输出 enableVirtualTerminal(); #endif auto words loadWordsFromFile(words.txt); if (words.empty()) { // 内置兜底词库 words { LAPPLE, LCRANE, LSLATE, LCRISP, LTRACE }; } std::cout Wordle - 命令行猜词游戏\n; bool playAgain true; while (playAgain) { WordleGame game(words, 6); game.run(); std::wcout L\n再来一局(y/n): ; wchar_t ch; std::wcin ch; playAgain (ch Ly || ch LY); } return 0; }这里有两个细节需要说明。第一std::wifstream配合std::locale(en_US.UTF-8)在Windows的MSVC和Linux的GCC下表现有差异如果读取中文词库出现乱码优先尝试用std::locale()或改用std::ifstream读字节流再手工转宽字符串。第二词库兜底用大写单词内部所有比较统一使用大写避免大小写转换的逻辑散落各处。4.3 evaluate函数整个游戏的核心判定函数是整个游戏算法的核心也是我前面反复强调的重复字母坑的答案所在std::vectorLetterResult WordleGame::evaluate(const std::wstring guess) const { std::vectorLetterResult results(guess.size()); std::unordered_mapwchar_t, int answerCount; for (wchar_t c : m_answer) answerCount[c]; // 第一遍标记绿色并消耗掉对应的计数 for (size_t i 0; i guess.size(); i) { results[i].ch guess[i]; if (guess[i] m_answer[i]) { results[i].type MatchType::EXACT; answerCount[guess[i]]--; } else { results[i].type MatchType::NONE; } } // 第二遍标记黄色注意不能超过剩余计数 for (size_t i 0; i guess.size(); i) { if (results[i].type MatchType::EXACT) continue; auto it answerCount.find(guess[i]); if (it ! answerCount.end() it-second 0) { results[i].type MatchType::EXISTS; it-second--; } } return results; }理解这个函数的关键在于绿色匹配也要消耗计数。比如答案APPLE玩家输入PIPES。第一遍时第二个字母I不是P第三个字母P也不是P因为答案下标2是P这里假设输入是PIPES下标2是P实际就是绿色所以绿色只有一个P被标记answerCount[P]从1变成0。第二遍处理下标0的第一个P时发现计数已经是0正确判为灰色。这样最终呈现的是一个绿色P没有黄色P符合Wordle真实规则。这个逻辑如果写反了先处理黄色再处理绿色或者不消耗计数结果就会错。我建议读者把这段代码单独拿出来用APPLE、SPEED、ABBEY这几种重复字母多的词多跑几遍用例比记住结论要有用得多。4.4 render函数与输入处理渲染分为三个区域历史记录、当前输入、昵称键盘状态。因为使用了ANSI颜色代码里我封装了一个小的颜色设置函数void WordleGame::render() const { system(clear); // Windows下改成 system(cls) std::wcout L\n W O R D L E\n\n; // 绘制每一行历史记录 for (int row 0; row m_maxGuesses; row) { if (row static_castint(m_history.size())) { for (const auto r : m_history[row]) { switch (r.type) { case MatchType::EXACT: std::wcout L\033[48;5;28m ; break; case MatchType::EXISTS: std::wcout L\033[48;5;220m ; break; case MatchType::NONE: std::wcout L\033[48;5;240m ; break; } std::wcout r.ch L \033[0m; } } else if (row m_currentRow) { // 当前行未提交的输入用默认白底显示 std::wcout L\033[48;5;255m\033[30m ; for (size_t i 0; i m_currentInput.size(); i) std::wcout m_currentInput[i] L ; for (size_t i m_currentInput.size(); i 5; i) std::wcout L_ ; std::wcout L\033[0m; } else { std::wcout L _ _ _ _ _ ; } std::wcout L\n\n; } // 绘制键盘状态 std::wcout L键盘状态: ; std::wstring alphabet LABCDEFGHIJKLMNOPQRSTUVWXYZ; for (wchar_t c : alphabet) { auto it m_keyState.find(c); if (it m_keyState.end()) std::wcout c L ; else if (it-second MatchType::EXACT) std::wcout L\033[48;5;28m c L\033[0m ; else if (it-second MatchType::EXISTS) std::wcout L\033[48;5;220m c L\033[0m ; else std::wcout L\033[48;5;240m c L\033[0m ; } std::wcout L\n; }clear和cls在不同系统上不一样为了跨平台我通常会再包一层。实际项目里不推荐反复调用system有安全和性能双重考量但作为一个学习项目直接这样写不用引入第三方库是取舍后的结果。如果你要发布到生产环境建议改用ANSI的\033[2J\033[H清屏序列或使用ncurses库。输入处理是另一个有意思的地方。不能直接用std::cin input因为我们需要监听退格键、回车键并且实时回显。所以在Windows下我用_getch()逐字符读取Linux下则用termios关闭行缓冲和回显void WordleGame::run() { while (m_currentRow m_maxGuesses) { render(); // 读取输入支持退格 m_currentInput.clear(); bool confirmed false; while (!confirmed) { wchar_t ch readKey(); // 封装了不同平台的逐字符读取 if (ch L\r || ch L\n) { if (m_currentInput.size() 5) confirmed true; } else if (ch 8 || ch 127) // 退格 { if (!m_currentInput.empty()) m_currentInput.pop_back(); } else { ch towupper(ch); if (ch LA ch LZ m_currentInput.size() 5) m_currentInput.push_back(ch); } render(); // 每次按键后重绘 } if (!isValidWord(m_currentInput)) { std::wcout L该词不在词库中请重新输入。\n; continue; } auto result evaluate(m_currentInput); m_history.push_back(result); updateKeyState(result); m_currentRow; bool allExact true; for (const auto r : result) if (r.type ! MatchType::EXACT) allExact false; if (allExact) { render(); std::wcout L恭喜你用了 m_currentRow L 次猜中。\n; return; } } render(); std::wcout L很遗憾答案是: m_answer L\n; }readKey()的Linux实现需要用到tcsetattr关闭ICANON和ECHO读取后再恢复。Windows下直接用_getwch()也可以但要注意宽字符模式下_getwch返回的是wchar_t类型。4.5 词库加载与随机选词构造WordleGame时我建议从词库里随机选词作为答案WordleGame::WordleGame(std::vectorstd::wstring words, int maxGuesses) : m_words(std::move(words)), m_maxGuesses(maxGuesses) { resetGame(); } void WordleGame::resetGame() { static std::random_device rd; static std::mt19937 gen(rd()); if (!m_words.empty()) { std::uniform_int_distributionsize_t dist(0, m_words.size() - 1); m_answer m_words[dist(gen)]; } m_currentRow 0; m_currentInput.clear(); m_history.clear(); m_keyState.clear(); }static局部变量让随机数引擎在多次重开游戏时复用避免每次构造都重新生成随机种子导致结果重复。resetGame和构造函数分离是为了方便以后做同一局重开功能。5. 从编译到运行踩过环境坑后的完整构建方案5.1 Windows环境下的编译运行在Windows下我推荐直接用Visual Studio的开发者命令行或者装一个MinGW-w64。如果用的是MSVCcl /EHsc /std:c17 main.cpp WordleGame.cpp /Fe:wordle.exe如果用的是MinGWg -stdc17 main.cpp WordleGame.cpp -o wordle.exe编译完成后运行wordle.exe。如果终端里出现一片乱码优先排查代码页问题。在main函数开头调用SetConsoleOutputCP(CP_UTF8)会好很多但要注意这个函数对标准输出流和宽字符流的作用范围有限必要时在main里先调用_setmode(_fileno(stdout), _O_U8TEXT)配合使用。另外Windows Terminal新版终端对ANSI颜色支持较好传统conhostWindows 10旧版可能会显示←[48;5;28m这种字面量。解决办法就是前面提到的enableVirtualTerminal()。5.2 Linux/macOS环境下编译Linux下编译只需要一条命令g -stdc17 main.cpp WordleGame.cpp -o wordle ./wordlemacOS的clang命令几乎一样注意可能需要-lcurses但本项目没有用ncurses所以不需要额外链接参数。有个远程服务器的坑提醒一下如果你通过SSH连接服务器运行这个程序system(clear)可以正常工作但中文词库的字体渲染取决于终端软件。Windows Terminal的SSH会话基本没问题老旧的Xterm可能显示不了中文。这种情况要么换成英文词库要么在词库里只放ASCII字符的短词。5.3 UTF-8词库与BOM的坑如果你维护的词库文件是UTF-8编码Windows记事本默认会保存成带BOM字节序标记的格式。std::wifstream读第一行时BOM会被当成一个不可见字符粘在第一个单词前面导致第一个单词的长度变成6或内容不匹配。解决办法有两种。一是用专门的文本编辑器VS Code、Notepad保存为UTF-8无BOM格式。二是在代码里读取前三个字节如果发现是EF BB BF就跳过static void skipUtf8Bom(std::wifstream fin) { wchar_t peek fin.peek(); if (peek 0xFEFF) fin.get(); // 吃掉BOM }注意peek()返回的是宽字符在UTF-8宽字符流下BOM会被整合成一个0xFEFF宽字符。这个坑在Windows平台特别常见我第一次做就踩了查了半天发现第一个词永远不对。6. 进阶扩展把Demo变成真正耐玩的作品6.1 统计与连续游戏基础的六次猜词循环做完之后第一个值得加的功能是统计系统。官方Wordle会记录玩家的猜中次数分布、连胜场次、当前连胜。实现这个功能只需要在main里维护几个变量同时把每局结果追加到本地文件里。我的做法是加一个简单的stats.txt每行记录一局结果格式为胜|败|猜中次数。启动时读取统计文件结束后写回。这样游戏退出再重开统计还在。6.2 硬模式与自定义词库官方有一个硬模式玩法如果你之前获得了黄色反馈后面的猜测必须包含那个字母绿色反馈的字母必须保持在原位。实现思路是每次校验输入时遍历之前所有的历史记录把约束条件逐条检查。这个逻辑不算复杂但写出来会逼你思考怎样从m_history中提取约束。自定义词库方面可以提供一个命令行参数指定词库文件wordle --words mylist.txt。解析命令行参数可以用std::string argv循环判断不需要第三方库。如果词库里混入了长度不为5的词加载时直接过滤掉这样对词库的宽容度更高玩家可以放任何词进去而不怕崩溃。6.3 后续还能往哪些方向走做完上面这些一个命令行Wordle就已经相当完整了。如果想继续深入可以试试这些方向把渲染改为双缓冲或局部刷新消除clear带来的闪烁感支持自定义每局的最大猜测次数比如7次、8次验证一下难度变化加入计时器记录每局用时用ncurses库重写渲染层做到不闪屏、支持任意终端大小扩展词库文件格式支持JSON以附带单词释义我在完成基础版本后最推荐的下一步是把system(clear)替换为ANSI清屏序列。这个改动虽然简单但会让你理解终端转义序列的运转机制同时整个程序的刷新体验会有明显提升。最后分享一个我自己的开发习惯每次在终端里看到编译错误先深呼吸从第一条错误开始看不要一口气往下扫。用这套流程做完这个Wordle项目中间被我修掉的类型错误、编码错误至少七八处每一处都让我对C的某个细节理解更深一层。如果你在实践过程中卡住了尽量先自己定位问题再回头对照这篇文章的代码。自己亲手修复过的坑记忆会深刻得多。
去年我带几个学过C基础的新手朋友做练习项目。计算器、图书管理系统这类题目做完的感觉就是会了但没完全会离真正的工程实践始终隔着一层。直到我把当年火出圈的Wordle改造成命令行版本他们才第一次体验到设计数据结构→实现规则→处理边界情况→打磨交互的完整链路。这个项目非常适合C入门之后、想通过动手巩固知识的人。它不依赖任何第三方库只用标准库就能写完覆盖了类设计、容器使用、随机数、输入输出控制、字符编码处理等高频知识点。同时规则足够简单——每次猜一个词得到三种颜色反馈最多猜6次——实现起来却有不少值得琢磨的细节。这篇文章会从规则梳理讲到完整源码再分享我在不同系统上编译运行踩过的坑以及后续可以扩展的方向。1. 为什么选Wordle作为C练手项目它比练习题更像真实工程1.1 一个练手项目应该满足什么条件我衡量一个练手项目值不值得做主要看三点。第一点是规则明确但不过于庞大。Wordle的规则可以在两三句话内说清楚但实现时要处理字母重复出现这种边界情况不会让人觉得无从下手也不会简单到没有思考量。第二点是能覆盖多种C核心语法。如果项目只用到cout和if做完基本没收获。Wordle需要你设计类来封装状态需要用vector保存多轮猜测记录需要unordered_map统计字母频次需要随机数从词库选答案还需要在输入输出上做精细控制。第三点是结果直观、有反馈感。命令行程序最难的就是反馈感但Wordle天然有颜色反馈和逐行显示的历史记录每次猜测都能立刻看到结果这种即时反馈对学习动力很有帮助。第三点我认为在练习中最容易被忽略。传统习题做完只有编译通过Wordle却能做出真正可以拿给别人玩、甚至骗到同事说你在终端里做wordle的小工具。1.2 这个项目覆盖的知识点清单如果把这个项目拆分一下每个模块对应的C知识点大致是这样的类与封装用一个WordleGame类管理答案、历史记录、当前输入标准容器std::vector存储历史结果std::unordered_map统计字母出现次数随机数std::mt19937和std::uniform_int_distribution从词库挑选答案文件操作从外部词库读取所有合法单词宽字符处理支持中文词库时必须用std::wstring和std::wcout程序流程控制游戏主循环、输入校验、胜负判定对初学者来说这恰好串起了一整条知识链。很多人学完STL容器后不知道什么时候该用哪个做完这个项目vector和unordered_map的适用场景基本就清楚了。1.3 和教材练习项目的本质差异这里的差异值得展开说一说。教材里的练习题通常把函数接口都给你定好了你只需要填空。而Wordle从零开始一切都要自己设计。比如每一次猜测的反馈结果用什么数据结构存放这个问题教材不会帮你回答你必须自己想清楚。选择vectorLetterResult还是二维数组取决于你要不要支持动态的猜词次数每个格子要不要保存字符和颜色状态取决于渲染时是否需要重绘历史记录。另外练习题往往有一个隐藏前提输入总是合法的。但真实程序必须考虑用户输入了一个不在词库里的词怎么办。这种防御性编程思维才是工程实践和习题之间最大的差别。2. 动手之前先理清规则状态机、判定逻辑与重复字母这个隐藏坑2.1 从官方规则到程序状态机写代码之前我习惯先画一遍逻辑流程图——不是要画给谁看而是为了逼自己把所有路径想清楚。Wordle的程序流程是这样的从词库随机选一个目标单词答案玩家输入一个猜测校验猜测是否合法长度正确、在词库中逐字母判定颜色绿色字母在答案中且位置正确黄色字母在答案中但位置不对灰色字母不在答案中如果全部绿色玩家胜利如果猜测次数耗尽显示答案玩家失败否则回到第2步这个流程对应到代码里就是一个主循环核心状态只有当前行号和游戏是否结束。真正的复杂点在步骤4——判定逻辑不能想当然地写。下面专门讲这个。2.2 三个颜色反馈的判定为什么不能直接双重循环很多人第一反应是对每个猜测字母遍历答案看它在不在、位置对不对。直接双重循环就会踩坑。我举个例子。假设答案是APPLE玩家输入PIPES。直观处理方式第一个P在答案中存在但位置不同 → 黄色第二个字母I不在答案中 → 灰色第三个字母P呢答案里只有一个P但第一个P已经占用了这个名额所以第三个P应该判灰色如果双重循环不加控制第三个P会因为答案中存在P而被标成黄色这就不对了。Wordle的官方规则是黄色标记不能超过答案中该字母的总次数。正确的做法分两遍处理。第一遍先标记所有绿色匹配同时记录答案中每个字母还剩余多少次可匹配机会。第二遍处理剩下的位置只有字母存在且剩余次数大于0才标黄色每次标记后把计数减一。这样每个字母的消耗都被精确追踪不会出现上面那种一个字母被重复计数的问题。这个地方是整个游戏算法的题眼写代码时值得单独抽出一个小函数来测试。我在调试时专门写了几组用例比如答案SPEED猜SEEKS、答案ABBEY猜BABES逼着程序处理重复字母的边界。2.3 键盘反馈与胜负条件除了每行的格子反馈Wordle还有一个键盘状态条记录每个字母目前被判定过的最高优先级颜色方便玩家排除字母。这里的优先级是绿色 黄色 灰色。实现时可以用一个std::mapwchar_t, MatchType来保存每次新判定结果产生后如果当前字母还没有记录或新的优先级更高就更新。胜负条件本身不复杂任意一行全绿就是胜利行数达到上限还没有全绿就是失败。但这里有一个容易被忽略的设计问题——玩家输入的词不在词库里怎么办。我做的处理是不消耗猜测次数直接提示不在词库中让玩家重新输入。这样玩家可以试探一些乱七八糟的组合而不受惩罚更接近官方体验。3. 模块边界与技术选型从能跑到好维护的工程化思路3.1 文件划分与类设计虽然项目规模不大我还是建议至少分成main.cpp、WordleGame.h、WordleGame.cpp三个文件。原因是强迫自己区分声明和定义感受头文件在编译流程中的作用。很多初学者在单个文件里写习惯了到多文件工程就懵用这个小项目过渡正好。WordleGame类的职责我控制在三块负责一局游戏的全部状态答案、最大猜测次数、历史记录、当前输入、键盘状态核心逻辑方法evaluate判定颜色、isValid校验输入、render绘制面板不负责的事情词库的加载解析单独放在loadWords函数里和游戏类解耦为什么把词库加载放外面因为加载词库和游戏逻辑是两件不同的事。词库可能来自文件也可能未来来自网络、来自数据库不该被绑定在游戏类里。接口层面WordleGame只接收一个std::vectorstd::wstring它对词库的来源一无所知。这就是依赖倒置的一个简单实践虽然讲得深了没必要但代码自然形成了这个结构。3.2 词库文件的组织方式词库文件我采用每行一个单词的纯文本格式。英文词库就放全小写的5字母单词中文词库就放5个汉字组成的词。为什么每行一个因为解析简单也方便人工维护和审查。如果担心词库太大加载慢后续可以改成二进制格式或哈希表快照但对这个小项目来说文本格式完全够用。词库文件还承担了一个隐藏作用输入校验。玩家猜的词必须在词库中就存在这是Wordle的规则之一。所以词库既是答案池也是合法输入的白名单。项目里我会内置一个words.txt如果用户没提供词库文件就使用代码内置的一组单词作为兜底。这样保证任何环境下载下来都能运行不会因为缺文件而劝退。3.3 颜色渲染方案ANSI转义序列与跨平台处理命令行显示颜色标准做法是ANSI转义序列。形如\033[背景色m的字符会被终端解释为颜色切换。绿色背景是\033[48;5;28m黄色背景是\033[48;5;220m灰色背景是\033[48;5;240m结束恢复默认是\033[0m。这种方案的坑在于Windows的经典控制台conhost旧版本默认不解释ANSI转义需要手动启用虚拟终端处理。还好Windows 10以上的新终端基本都默认支持如果遇到老环境可以通过设置控制台模式来开启。我用一个小的封装接口来处理#ifdef _WIN32 #include windows.h void enableVirtualTerminal() { HANDLE hOut GetStdHandle(STD_OUTPUT_HANDLE); DWORD mode 0; GetConsoleMode(hOut, mode); SetConsoleMode(hOut, mode | ENABLE_VIRTUAL_TERMINAL_PROCESSING); } #endifmacOS和Linux终端天然支持完全不需处理。所以跨平台代码里这个函数只对Windows有条件编译。4. 源码拆解核心数据结构、判定函数与游戏主循环4.1 项目文件总览我实际跑通的项目文件结构是wordle-cli/ ├── main.cpp ├── WordleGame.h ├── WordleGame.cpp ├── words.txt └── CMakeLists.txt其中main.cpp负责入口逻辑启用控制台特性、加载词库、创建WordleGame对象并循环进行多局游戏。下面先看WordleGame.h的完整声明。// WordleGame.h #pragma once #include string #include vector #include map #include unordered_map enum class MatchType { EXACT, // 绿色位置和字母都正确 EXISTS, // 黄色字母在答案中但位置不对 NONE // 灰色字母不在答案中 }; struct LetterResult { wchar_t ch; MatchType type; }; class WordleGame { public: WordleGame(std::vectorstd::wstring words, int maxGuesses 6); void run(); private: std::vectorstd::wstring m_words; std::wstring m_answer; int m_maxGuesses; int m_currentRow 0; std::wstring m_currentInput; std::vectorstd::vectorLetterResult m_history; std::mapwchar_t, MatchType m_keyState; std::vectorLetterResult evaluate(const std::wstring guess) const; void updateKeyState(const std::vectorLetterResult row); void render() const; bool isValidWord(const std::wstring word) const; void resetGame(); };m_currentRow记录当前正在填写的行号m_history保存之后所有判定过的行m_currentInput保存玩家正在输入但还没提交的字母m_keyState用于键盘状态条。4.2 main函数与多局游戏循环main.cpp里除了加载词库还负责让玩家可以玩完一局再来一局// main.cpp #include iostream #include fstream #include string #include vector #include random #include WordleGame.h #ifdef _WIN32 #include windows.h #endif static std::vectorstd::wstring loadWordsFromFile(const std::string path) { std::vectorstd::wstring result; std::wifstream fin(path, std::ios::binary); if (!fin) return result; fin.imbue(std::locale(en_US.UTF-8)); // 视操作系统和编译器调整 std::wstring line; while (std::getline(fin, line)) { // 去除行尾的 \rWindows文本文件和首尾空白 while (!line.empty() (line.back() L\r || line.back() L )) line.pop_back(); if (line.size() 5) result.push_back(line); } return result; } int main() { #ifdef _WIN32 SetConsoleOutputCP(CP_UTF8); // 确保中文正常输出 enableVirtualTerminal(); #endif auto words loadWordsFromFile(words.txt); if (words.empty()) { // 内置兜底词库 words { LAPPLE, LCRANE, LSLATE, LCRISP, LTRACE }; } std::cout Wordle - 命令行猜词游戏\n; bool playAgain true; while (playAgain) { WordleGame game(words, 6); game.run(); std::wcout L\n再来一局(y/n): ; wchar_t ch; std::wcin ch; playAgain (ch Ly || ch LY); } return 0; }这里有两个细节需要说明。第一std::wifstream配合std::locale(en_US.UTF-8)在Windows的MSVC和Linux的GCC下表现有差异如果读取中文词库出现乱码优先尝试用std::locale()或改用std::ifstream读字节流再手工转宽字符串。第二词库兜底用大写单词内部所有比较统一使用大写避免大小写转换的逻辑散落各处。4.3 evaluate函数整个游戏的核心判定函数是整个游戏算法的核心也是我前面反复强调的重复字母坑的答案所在std::vectorLetterResult WordleGame::evaluate(const std::wstring guess) const { std::vectorLetterResult results(guess.size()); std::unordered_mapwchar_t, int answerCount; for (wchar_t c : m_answer) answerCount[c]; // 第一遍标记绿色并消耗掉对应的计数 for (size_t i 0; i guess.size(); i) { results[i].ch guess[i]; if (guess[i] m_answer[i]) { results[i].type MatchType::EXACT; answerCount[guess[i]]--; } else { results[i].type MatchType::NONE; } } // 第二遍标记黄色注意不能超过剩余计数 for (size_t i 0; i guess.size(); i) { if (results[i].type MatchType::EXACT) continue; auto it answerCount.find(guess[i]); if (it ! answerCount.end() it-second 0) { results[i].type MatchType::EXISTS; it-second--; } } return results; }理解这个函数的关键在于绿色匹配也要消耗计数。比如答案APPLE玩家输入PIPES。第一遍时第二个字母I不是P第三个字母P也不是P因为答案下标2是P这里假设输入是PIPES下标2是P实际就是绿色所以绿色只有一个P被标记answerCount[P]从1变成0。第二遍处理下标0的第一个P时发现计数已经是0正确判为灰色。这样最终呈现的是一个绿色P没有黄色P符合Wordle真实规则。这个逻辑如果写反了先处理黄色再处理绿色或者不消耗计数结果就会错。我建议读者把这段代码单独拿出来用APPLE、SPEED、ABBEY这几种重复字母多的词多跑几遍用例比记住结论要有用得多。4.4 render函数与输入处理渲染分为三个区域历史记录、当前输入、昵称键盘状态。因为使用了ANSI颜色代码里我封装了一个小的颜色设置函数void WordleGame::render() const { system(clear); // Windows下改成 system(cls) std::wcout L\n W O R D L E\n\n; // 绘制每一行历史记录 for (int row 0; row m_maxGuesses; row) { if (row static_castint(m_history.size())) { for (const auto r : m_history[row]) { switch (r.type) { case MatchType::EXACT: std::wcout L\033[48;5;28m ; break; case MatchType::EXISTS: std::wcout L\033[48;5;220m ; break; case MatchType::NONE: std::wcout L\033[48;5;240m ; break; } std::wcout r.ch L \033[0m; } } else if (row m_currentRow) { // 当前行未提交的输入用默认白底显示 std::wcout L\033[48;5;255m\033[30m ; for (size_t i 0; i m_currentInput.size(); i) std::wcout m_currentInput[i] L ; for (size_t i m_currentInput.size(); i 5; i) std::wcout L_ ; std::wcout L\033[0m; } else { std::wcout L _ _ _ _ _ ; } std::wcout L\n\n; } // 绘制键盘状态 std::wcout L键盘状态: ; std::wstring alphabet LABCDEFGHIJKLMNOPQRSTUVWXYZ; for (wchar_t c : alphabet) { auto it m_keyState.find(c); if (it m_keyState.end()) std::wcout c L ; else if (it-second MatchType::EXACT) std::wcout L\033[48;5;28m c L\033[0m ; else if (it-second MatchType::EXISTS) std::wcout L\033[48;5;220m c L\033[0m ; else std::wcout L\033[48;5;240m c L\033[0m ; } std::wcout L\n; }clear和cls在不同系统上不一样为了跨平台我通常会再包一层。实际项目里不推荐反复调用system有安全和性能双重考量但作为一个学习项目直接这样写不用引入第三方库是取舍后的结果。如果你要发布到生产环境建议改用ANSI的\033[2J\033[H清屏序列或使用ncurses库。输入处理是另一个有意思的地方。不能直接用std::cin input因为我们需要监听退格键、回车键并且实时回显。所以在Windows下我用_getch()逐字符读取Linux下则用termios关闭行缓冲和回显void WordleGame::run() { while (m_currentRow m_maxGuesses) { render(); // 读取输入支持退格 m_currentInput.clear(); bool confirmed false; while (!confirmed) { wchar_t ch readKey(); // 封装了不同平台的逐字符读取 if (ch L\r || ch L\n) { if (m_currentInput.size() 5) confirmed true; } else if (ch 8 || ch 127) // 退格 { if (!m_currentInput.empty()) m_currentInput.pop_back(); } else { ch towupper(ch); if (ch LA ch LZ m_currentInput.size() 5) m_currentInput.push_back(ch); } render(); // 每次按键后重绘 } if (!isValidWord(m_currentInput)) { std::wcout L该词不在词库中请重新输入。\n; continue; } auto result evaluate(m_currentInput); m_history.push_back(result); updateKeyState(result); m_currentRow; bool allExact true; for (const auto r : result) if (r.type ! MatchType::EXACT) allExact false; if (allExact) { render(); std::wcout L恭喜你用了 m_currentRow L 次猜中。\n; return; } } render(); std::wcout L很遗憾答案是: m_answer L\n; }readKey()的Linux实现需要用到tcsetattr关闭ICANON和ECHO读取后再恢复。Windows下直接用_getwch()也可以但要注意宽字符模式下_getwch返回的是wchar_t类型。4.5 词库加载与随机选词构造WordleGame时我建议从词库里随机选词作为答案WordleGame::WordleGame(std::vectorstd::wstring words, int maxGuesses) : m_words(std::move(words)), m_maxGuesses(maxGuesses) { resetGame(); } void WordleGame::resetGame() { static std::random_device rd; static std::mt19937 gen(rd()); if (!m_words.empty()) { std::uniform_int_distributionsize_t dist(0, m_words.size() - 1); m_answer m_words[dist(gen)]; } m_currentRow 0; m_currentInput.clear(); m_history.clear(); m_keyState.clear(); }static局部变量让随机数引擎在多次重开游戏时复用避免每次构造都重新生成随机种子导致结果重复。resetGame和构造函数分离是为了方便以后做同一局重开功能。5. 从编译到运行踩过环境坑后的完整构建方案5.1 Windows环境下的编译运行在Windows下我推荐直接用Visual Studio的开发者命令行或者装一个MinGW-w64。如果用的是MSVCcl /EHsc /std:c17 main.cpp WordleGame.cpp /Fe:wordle.exe如果用的是MinGWg -stdc17 main.cpp WordleGame.cpp -o wordle.exe编译完成后运行wordle.exe。如果终端里出现一片乱码优先排查代码页问题。在main函数开头调用SetConsoleOutputCP(CP_UTF8)会好很多但要注意这个函数对标准输出流和宽字符流的作用范围有限必要时在main里先调用_setmode(_fileno(stdout), _O_U8TEXT)配合使用。另外Windows Terminal新版终端对ANSI颜色支持较好传统conhostWindows 10旧版可能会显示←[48;5;28m这种字面量。解决办法就是前面提到的enableVirtualTerminal()。5.2 Linux/macOS环境下编译Linux下编译只需要一条命令g -stdc17 main.cpp WordleGame.cpp -o wordle ./wordlemacOS的clang命令几乎一样注意可能需要-lcurses但本项目没有用ncurses所以不需要额外链接参数。有个远程服务器的坑提醒一下如果你通过SSH连接服务器运行这个程序system(clear)可以正常工作但中文词库的字体渲染取决于终端软件。Windows Terminal的SSH会话基本没问题老旧的Xterm可能显示不了中文。这种情况要么换成英文词库要么在词库里只放ASCII字符的短词。5.3 UTF-8词库与BOM的坑如果你维护的词库文件是UTF-8编码Windows记事本默认会保存成带BOM字节序标记的格式。std::wifstream读第一行时BOM会被当成一个不可见字符粘在第一个单词前面导致第一个单词的长度变成6或内容不匹配。解决办法有两种。一是用专门的文本编辑器VS Code、Notepad保存为UTF-8无BOM格式。二是在代码里读取前三个字节如果发现是EF BB BF就跳过static void skipUtf8Bom(std::wifstream fin) { wchar_t peek fin.peek(); if (peek 0xFEFF) fin.get(); // 吃掉BOM }注意peek()返回的是宽字符在UTF-8宽字符流下BOM会被整合成一个0xFEFF宽字符。这个坑在Windows平台特别常见我第一次做就踩了查了半天发现第一个词永远不对。6. 进阶扩展把Demo变成真正耐玩的作品6.1 统计与连续游戏基础的六次猜词循环做完之后第一个值得加的功能是统计系统。官方Wordle会记录玩家的猜中次数分布、连胜场次、当前连胜。实现这个功能只需要在main里维护几个变量同时把每局结果追加到本地文件里。我的做法是加一个简单的stats.txt每行记录一局结果格式为胜|败|猜中次数。启动时读取统计文件结束后写回。这样游戏退出再重开统计还在。6.2 硬模式与自定义词库官方有一个硬模式玩法如果你之前获得了黄色反馈后面的猜测必须包含那个字母绿色反馈的字母必须保持在原位。实现思路是每次校验输入时遍历之前所有的历史记录把约束条件逐条检查。这个逻辑不算复杂但写出来会逼你思考怎样从m_history中提取约束。自定义词库方面可以提供一个命令行参数指定词库文件wordle --words mylist.txt。解析命令行参数可以用std::string argv循环判断不需要第三方库。如果词库里混入了长度不为5的词加载时直接过滤掉这样对词库的宽容度更高玩家可以放任何词进去而不怕崩溃。6.3 后续还能往哪些方向走做完上面这些一个命令行Wordle就已经相当完整了。如果想继续深入可以试试这些方向把渲染改为双缓冲或局部刷新消除clear带来的闪烁感支持自定义每局的最大猜测次数比如7次、8次验证一下难度变化加入计时器记录每局用时用ncurses库重写渲染层做到不闪屏、支持任意终端大小扩展词库文件格式支持JSON以附带单词释义我在完成基础版本后最推荐的下一步是把system(clear)替换为ANSI清屏序列。这个改动虽然简单但会让你理解终端转义序列的运转机制同时整个程序的刷新体验会有明显提升。最后分享一个我自己的开发习惯每次在终端里看到编译错误先深呼吸从第一条错误开始看不要一口气往下扫。用这套流程做完这个Wordle项目中间被我修掉的类型错误、编码错误至少七八处每一处都让我对C的某个细节理解更深一层。如果你在实践过程中卡住了尽量先自己定位问题再回头对照这篇文章的代码。自己亲手修复过的坑记忆会深刻得多。
