1. 从零实现 TextBox 搜索替换C# 桌面开发入门最值得练的一个小功能如果你正在学 C# 桌面开发想找一个既能练控件操作、又能练字符串处理、还能顺手把 AI 辅助编码跑通的小练习那 TextBox 的搜索替换几乎是量身定做的题目。它看起来简单但真正动手写就会发现坑不少第一次没搜索就直接点替换怎么办手动选中一段文字再点替换要不要生效搜到末尾之后怎么回到开头替换前要不要弹窗二次确认这些问题在真实的记事本、代码编辑器里都有对应处理练一遍等于把 WinForms 里最常用的几个 API 全过了一遍。这篇内容面向的是刚接触 C# 和 WinForms 的入门同学也适合培训课上当随堂练习。我会先给出一个能直接复制运行的完整实现把搜索、替换、循环查找、二次确认这些逻辑讲清楚然后演示怎么用 TaoToken 统一 Key 和 API 通道让模型帮你生成代码骨架、检查边界条件、解释报错。整个过程不需要你折腾多个平台的账号一个 Key 就能调用主流模型对新手来说省事很多。核心检索词先明确一下C# TextBox 搜索替换、WinForms 查找下一个、SelectedText 替换、IndexOf 循环查找、TaoToken 辅助写代码。下面所有代码都基于 .NET Framework 或 .NET 6 的 WinForms控件命名保持一致你可以直接对照自己的窗体改。先说清楚这个练习最终要达成的效果一个多行 TextBox 作为输入区两个单行 TextBox 分别填搜索词和替换词四个按钮负责「搜索下一个」「替换当前」「全部替换」「清空」。搜索时高亮匹配项并把光标定位过去替换时如果当前没有选中匹配项就先执行一次搜索而不是直接替换如果用户手动选中了别的文字也先搜索下一个匹配项。搜到末尾弹提示并回到开头。替换前用 MessageBox 做二次确认。这些规则听起来琐碎但正是它们让这个小练习有了「像真软件」的质感。2. TaoToken 前置准备统一 Key 与 API 通道让模型辅助写 C# 代码在动手写代码之前先把 AI 辅助这条线搭好。很多同学卡在第一步想用模型帮忙生成或检查代码结果发现要注册好几个平台、管理好几套 Key、每个平台的接口格式还不一样。TaoToken 解决的就是这个问题——它提供统一的 API 通道你只需要一个 Key就能通过兼容 OpenAI 的接口格式调用不同模型。对 C# 入门练习来说这意味着你可以把精力放在代码逻辑上而不是折腾账号。先访问官网了解整体情况https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注册登录后进入控制台在 API Keys 页面创建一个新的 Key。这个 Key 就是后面所有请求的凭证格式通常以 sk- 开头。创建完记得复制保存页面刷新后一般不再完整显示。拿到 Key 之后你需要知道两个关键信息Base URL 和 Model ID。Base URL 统一用 https://taotoken.net/api 注意这个地址后面不加任何 UTM 参数直接作为 OpenAI 兼容接口的 base。Model ID 则根据你要用的模型填写比如常见的对话模型或代码模型具体可用的模型列表在文档里能查到。接入文档地址是 https://taotoken.net/doc 里面有各语言的调用示例C# 用 HttpClient 就能直接发请求。这里要强调一个新手最容易踩的坑Base URL 和完整请求路径的区别。OpenAI 兼容接口的对话补全路径是 /v1/chat/completions所以如果你用 HttpClient 手写请求完整地址应该是 https://taotoken.net/api/v1/chat/completions 。但如果你用的是官方 OpenAI SDK 或兼容库通常只需要把 BaseUrl 设成 https://taotoken.net/api SDK 会自动拼接后面的路径。搞混这两个会导致 404后面排障章节会详细讲。为什么建议在写这个小练习时就用上 AI 辅助因为搜索替换的边界条件特别多人脑容易漏。你可以把需求描述给模型让它先列出所有需要处理的场景再逐个实现。比如「第一次没搜索就点替换」「手动选中非搜索词」「搜到末尾循环」这几条模型能帮你补全思路。而且写完代码后把代码贴回去让模型 review往往能发现你没想到的 bug。这种「生成 校验」的用法比单纯让模型写完整代码更有学习价值。配置方面如果你用的是 Visual Studio可以在项目里建一个 appsettings.json 或者直接用常量存 Key。但练习阶段更推荐用环境变量避免 Key 被提交到代码仓库。在 Windows 上可以用 setx TAOTOKEN_API_KEY 你的Key 设置然后在 C# 里用 Environment.GetEnvironmentVariable 读取。这样既安全又方便切换。如果你更习惯用命令行工具或编辑器插件来调用模型TaoToken 也支持通过配置 Base URL 和 Key 的方式接入具体可以参考文档里的说明。3. 可复制配置与完整 WinForms 代码实现这一节是重头戏给出可以直接跑起来的完整代码。先看界面控件的命名建议统一成下面这样方便对照控件类型名称用途TextBox (Multiline)txtInput主输入区被搜索和替换的文本TextBoxtxtSearch搜索关键词TextBoxtxtReplace替换词ButtonbtnSearch搜索下一个ButtonbtnReplace替换当前ButtonbtnReplaceAll全部替换ButtonbtnClear清空窗体加载时把 txtInput 的 HideSelection 设为 false这样即使焦点不在输入框上选中的文字也会保持高亮。这一点很关键否则用户点搜索按钮后焦点转移高亮就消失了体验很差。写在 Form_Load 里private void Form1_Load(object sender, EventArgs e) { txtInput.Multiline true; txtInput.ScrollBars ScrollBars.Vertical; txtInput.HideSelection false; // 失焦也保持高亮 txtInput.SelectionStart 0; txtInput.SelectionLength 0; }接下来是搜索逻辑。核心是用 IndexOf 从当前光标位置往后找找到就设置 SelectionStart 和 SelectionLength 实现高亮。如果返回 -1说明到底了弹提示并回到开头。这里要注意一个细节搜索的起始位置应该是「当前选中区域的末尾」否则会一直找到同一个位置。所以起始索引是 SelectionStart SelectionLength。private int FindNext(string source, string keyword, int startIndex) { if (string.IsNullOrEmpty(keyword)) return -1; return source.IndexOf(keyword, startIndex, StringComparison.CurrentCultureIgnoreCase); } private void btnSearch_Click(object sender, EventArgs e) { string keyword txtSearch.Text; if (string.IsNullOrEmpty(keyword)) { MessageBox.Show(请先输入搜索内容); return; } int startIndex txtInput.SelectionStart txtInput.SelectionLength; int index FindNext(txtInput.Text, keyword, startIndex); if (index -1) { // 到底了回到开头再找一次 index FindNext(txtInput.Text, keyword, 0); if (index -1) { MessageBox.Show(未找到匹配内容); return; } MessageBox.Show(已搜索到最底部从开头继续); } txtInput.Focus(); txtInput.SelectionStart index; txtInput.SelectionLength keyword.Length; txtInput.ScrollToCaret(); }替换逻辑要处理三种情况这正是 excerpt 里强调的「需要保护的规格」。第一种用户没搜索过就直接点替换此时 SelectionLength 为 0应该先执行一次搜索而不是替换。第二种用户手动选中了一段文字但选中的不是搜索词也应该先搜索下一个匹配项。第三种选中的正好是搜索词才执行替换。替换前用 MessageBox 二次确认用 DialogResult 接收结果。private void btnReplace_Click(object sender, EventArgs e) { string keyword txtSearch.Text; if (string.IsNullOrEmpty(keyword)) { MessageBox.Show(请先输入搜索内容); return; } // 情况一没有选中任何内容先搜索 if (txtInput.SelectionLength 0) { btnSearch_Click(this, e); return; } // 情况二选中的不是搜索词先搜索下一个 if (txtInput.SelectedText ! keyword) { btnSearch_Click(this, e); return; } // 情况三选中的正是搜索词二次确认后替换 DialogResult result MessageBox.Show( 确定要替换吗, 二次确认, MessageBoxButtons.YesNo, MessageBoxIcon.Question); if (result DialogResult.No) return; int replaceStart txtInput.SelectionStart; txtInput.SelectedText txtReplace.Text; // 替换后光标移到替换内容之后继续找下一个 txtInput.SelectionStart replaceStart txtReplace.Text.Length; txtInput.SelectionLength 0; btnSearch_Click(this, e); }全部替换就简单一些循环查找并替换直到 IndexOf 返回 -1。注意每次替换后起始位置要往后推避免死循环。这里用一个 while 循环配合索引变量private void btnReplaceAll_Click(object sender, EventArgs e) { string keyword txtSearch.Text; string replacement txtReplace.Text; if (string.IsNullOrEmpty(keyword)) { MessageBox.Show(请先输入搜索内容); return; } DialogResult result MessageBox.Show( $确定要把所有「{keyword}」替换为「{replacement}」吗, 二次确认, MessageBoxButtons.YesNo, MessageBoxIcon.Warning); if (result DialogResult.No) return; string text txtInput.Text; int count 0; int index 0; while ((index text.IndexOf(keyword, index, StringComparison.CurrentCultureIgnoreCase)) ! -1) { text text.Remove(index, keyword.Length).Insert(index, replacement); index replacement.Length; count; } txtInput.Text text; MessageBox.Show($共替换 {count} 处); }如果你想让模型帮你检查这段代码可以把上面的需求描述和代码一起发给它问「这段替换逻辑有没有漏掉的边界情况」。实测下来模型通常能指出「替换后光标位置处理」「大小写敏感」「空替换词」这几个点。这就是 AI 辅助的价值不是替你写而是帮你查漏。调用时用 HttpClient 发一个 POST 请求到 https://taotoken.net/api/v1/chat/completions Header 里带 Authorization: Bearer 你的KeyBody 里放 model 和 messages 即可。具体 JSON 结构参考文档这里不展开。4. 验证请求与运行测试确认搜索定位和批量替换结果代码写完之后必须实际跑一遍验证。打开 Visual Studio按 F5 启动在 txtInput 里粘贴一段测试文本比如重复几遍「hello world」和「C# 练习」。然后按下面的步骤逐条测试每一条都对应一个边界条件。第一步测试基本搜索。在 txtSearch 输入「C#」点「搜索下一个」观察是否高亮第一个匹配项光标是否定位过去。再点一次应该跳到第二个匹配项。连续点到最后一个之后应该弹出「已搜索到最底部从开头继续」然后回到第一个匹配项。这一步验证的是 IndexOf 的起始位置计算和循环逻辑。第二步测试「未搜索直接替换」。清空选中确保 SelectionLength 为 0直接点「替换当前」。预期行为是先执行一次搜索高亮第一个匹配项而不是直接替换。这一步验证的是 SelectionLength 0 的保护逻辑。如果你发现它直接替换了说明保护判断没生效检查 btnReplace_Click 里的第一个 if。第三步测试「手动选中非搜索词」。用鼠标在 txtInput 里随便选一段文字确保选中的不是搜索词然后点「替换当前」。预期行为是先搜索下一个匹配项而不是替换你选中的内容。这一步验证的是 SelectedText ! keyword 的判断。注意这里用的是精确比较如果你希望忽略大小写可以改成 string.Equals 带 StringComparison。第四步测试「手动选中搜索词」。用鼠标精确选中一个搜索词点「替换当前」应该弹出二次确认框。点「是」执行替换点「否」取消。替换后光标应该移到替换内容之后并自动搜索下一个。这一步验证的是 DialogResult 的处理和替换后的光标定位。第五步测试「全部替换」。在 txtSearch 输入一个出现多次的词点「全部替换」确认弹窗后点「是」观察是否所有匹配项都被替换并弹出替换数量提示。这里要特别注意如果替换词里包含搜索词比如把「ab」替换成「abc」循环逻辑可能会重复匹配。上面的代码用 index replacement.Length 避免了这个问题你可以专门测一下这个场景。第六步测试「清空」按钮。这个最简单把三个 TextBox 都清空光标归位。虽然简单但别忘了写否则用户测试完想重新来一遍还得手动删。跑完这六步如果全部符合预期说明核心逻辑没问题。如果有哪一步不对先别急着改代码把现象和你的预期描述给模型让它帮你分析可能的原因。比如「我点替换当前它没有先搜索而是直接替换了」模型会提示你检查 SelectionLength 的判断顺序。这种「描述现象 让模型推理」的方式比直接问「代码哪里错了」更有效因为你在训练自己的调试思维。另外验证 API 通道是否通的时候可以写一个最简单的控制台测试用 HttpClient 发一个「你好」给模型看能不能收到回复。如果能收到说明 Key 和 Base URL 配置正确。如果报 401检查 Key 是否复制完整如果报 404检查路径是不是漏了 /v1/chat/completions如果报连接超时检查网络和 Base URL 是否写错。这些排查思路在下一节详细展开。5. 本篇常见错误排查401、404、local proxy failed 与 OAuth 报错新手在跑这个练习时报错主要集中在两类一类是 C# 代码本身的逻辑错误一类是调用 TaoToken API 时的配置错误。先说你试过最容易踩的 C# 坑。第一个常见错误是「替换后光标位置不对导致死循环」。现象是点一次替换后再点搜索一直停在同一个位置。原因通常是替换后没有更新 SelectionStart或者更新成了替换前的位置。正确做法是替换后把 SelectionStart 设为 replaceStart txtReplace.Text.Length这样下一次搜索从替换内容之后开始。如果你把起始位置设成了 replaceStart而替换词又包含搜索词就会无限匹配。第二个常见错误是「HideSelection 没设高亮消失」。现象是点搜索按钮后输入框里的高亮一闪而过因为焦点转移到按钮上了。解决办法就是在 Form_Load 里把 txtInput.HideSelection 设为 false。这个属性默认是 true意思是失去焦点时隐藏选中。很多教程不讲这个导致新手以为搜索没生效。第三个常见错误是「IndexOf 起始位置算错跳过匹配项」。如果你用 SelectionStart 作为起始位置而不是 SelectionStart SelectionLength那么当前选中的匹配项会被再次找到表现为「点搜索没反应」。记住搜索要从当前选中区域的末尾开始。接下来是 API 调用相关的报错这些在文档和社区里出现频率很高逐个对照。401 Unauthorized最常见的原因是 Key 没填、填错、或者复制时带了空格。检查 Authorization 头是不是 Bearer 加空格加 KeyKey 是否完整。另外注意 Key 是否过期或被删除去控制台确认一下。如果用的是环境变量确认变量名拼写正确且重启了 IDE 让变量生效。404 Not Found几乎都是路径问题。如果你手写 HttpClient完整地址必须是 https://taotoken.net/api/v1/chat/completions 。少写 /v1 或者多写 /api 都会 404。如果你用 SDKBaseUrl 设成 https://taotoken.net/api 即可不要在后面加 /v1。这两种用法的区别要记牢。local proxy failed这个报错通常出现在你本地配置了代理但代理没启动或端口不对。解决办法是检查系统代理设置或者在代码里显式设置 HttpClient 不使用代理。如果你在公司网络环境下可能需要联系网管确认出口策略。注意这里说的是本地开发环境的网络配置问题不涉及任何绕过网络管理的手段纯粹是排查配置错误。reading choices 相关报错如果你解析响应时按 OpenAI 格式取 choices[0].message.content但报错说找不到 choices先打印完整响应体看看结构。有时候是模型返回了错误信息而不是正常补全比如额度不足或参数错误。把原始响应打出来对照文档里的返回格式就能定位问题。OAuth 相关报错如果你用的是某些需要 OAuth 授权的客户端工具报错提示 token 无效或授权失败检查是不是把 API Key 和 OAuth token 搞混了。TaoToken 的 API 调用用的是 Bearer Key不是 OAuth 流程。如果你在配置 Claude Code 或类似工具注意区分「API Key 模式」和「OAuth 模式」按文档选择正确的接入方式。还有一个新手常问的问题为什么我替换全部之后替换数量对不上检查你的搜索是否区分大小写。上面的代码用了 StringComparison.CurrentCultureIgnoreCase所以「Hello」和「hello」都会被匹配。如果你希望区分大小写改成 StringComparison.Ordinal。这个选择取决于你的需求没有绝对对错但要清楚自己用的是哪种。排查的时候建议把错误信息完整复制给模型让它帮你解释。比如把 401 的响应体贴进去问「这个报错在 C# 调用 OpenAI 兼容接口时通常是什么原因」。模型能给出针对性的排查步骤比你自己瞎试快得多。这就是把 AI 辅助用在调试环节的价值。6. 把练习变成能力后续可以继续扩展的方向这个小练习跑通之后你已经掌握了 WinForms 里 TextBox 的核心操作SelectionStart、SelectionLength、SelectedText、HideSelection、ScrollToCaret以及 IndexOf 的循环查找。这些 API 在真实的文本编辑器、日志查看器、配置管理工具里都会用到。接下来可以尝试几个扩展方向让练习更接近实用。第一个方向是加上「区分大小写」和「全词匹配」的复选框。区分大小写就是把 StringComparison 换成 Ordinal全词匹配则需要检查匹配位置的前后字符是不是字母数字。这两个功能加起来你的搜索就接近专业编辑器了。第二个方向是把搜索替换逻辑抽成一个独立的类比如 TextSearcher把查找、替换、循环这些方法封装进去。这样窗体代码只负责界面交互逻辑和界面分离是迈向工程化的第一步。抽离之后你还可以给这个类写单元测试用 xUnit 或 NUnit 验证各种边界条件不用每次都手动点按钮。第三个方向是接入 AI 做「智能替换」。比如用户输入一个正则表达式或者自然语言描述让模型生成替换规则。这需要你把用户输入发给模型拿到返回的规则后再应用到 TextBox。这个扩展能把你的练习从「字符串操作」升级到「AI 辅助文本处理」很有意思。如果你在扩展过程中遇到问题或者想让模型帮你设计架构可以继续用 TaoToken 的通道。需要提醒的是长期做编码和 Agent 类任务的话可以了解一下 Coding Plan它在调用额度和稳定性上更适合持续开发场景。日常验证模型效果、测试 prompt用模型对话就够了。接入文档里有各语言的完整示例遇到配置问题先查文档大部分坑里面都有说明。最后说一个实用技巧把这次练习的代码和踩坑记录整理成一个 Markdown 笔记下次遇到类似需求直接翻。比如「TextBox 失焦高亮用 HideSelection false」「替换前判断 SelectionLength 0」「IndexOf 起始位置要加 SelectionLength」这几条记下来以后写任何文本搜索功能都能用上。练习的价值不在于写完就扔而在于把踩过的坑变成自己的经验库。