一种有趣、实用且具有状态的构建终端应用程序的方式。这是一个基于Elm架构的Go框架。泡泡茶非常适合构建简单和复杂的终端应用程序,无论是内联、全窗口还是两者的混合。
<p> <img src="https://yellow-cdn.veclightyear.com/835a84d5/bcef421b-fd4b-4adb-be05-60479a594ca3.gif" width="100%" alt="泡泡茶示例"> </p>泡泡茶已在生产环境中使用,并包含了我们在开发过程中添加的许多功能和性能优化。其中包括基于标准帧率的渲染器、与主渲染器一起工作的高性能可滚动区域渲染器以及鼠标支持。
要开始使用,请参阅下面的教程、[示例][examples]、[文档][docs]、视频教程以及一些常见的资源。
请务必查看Bubbles,这是一个用于泡泡茶的常用UI组件库。
<p> <a href="https://github.com/charmbracelet/bubbles"><img src="https://yellow-cdn.veclightyear.com/835a84d5/0ea27b6f-c629-4e08-afde-8a27f234e7f1.png" width="174" alt="Bubbles徽章"></a> <a href="https://github.com/charmbracelet/bubbles"><img src="https://yellow-cdn.veclightyear.com/835a84d5/047ba67d-e78e-471f-84da-e4dfc28bf319.gif" width="400" alt="Bubbles中的文本输入示例"></a> </p>泡泡茶基于Elm架构的函数式设计范式,这与Go语言非常契合。这是一种令人愉悦的构建应用程序的方式。
本教程假设您已经具备Go 语言的工作知识。
顺便说一下,这个程序的未注释源代码可在GitHub上获得。
在本教程中,我们将制作一个购物清单。
首先,我们定义包并导入一些库。我们唯一的外部导入将是泡泡茶库,我们将其简称为tea
。
package main import ( "fmt" "os" tea "github.com/charmbracelet/bubbletea" )
泡泡茶程序由描述应用程序状态的模型和该模型上的三个简单方法组成:
让我们从定义我们的模型开始,它将存储我们应用程序的状态。它可以是任何类型,但通常结构体最有意义。
type model struct { choices []string // 待办事项列表中的项目 cursor int // 光标指向的待办事项 selected map[int]struct{} // 被选中的待办事项 }
接下来,我们将定义应用程序的初始状态。在这个例子中,我们定义了一个函数来返回我们的初始模型,但我们也可以在其他地方将初始模型定义为变量。
func initialModel() model { return model{ // 我们的待办事项列表是一个购物清单 choices: []string{"买胡萝卜", "买芹菜", "买大头菜"}, // 一个表示哪些选项被选中的映射。我们将这个映射用作数学集合。 // 键指的是上面`choices`切片的索引。 selected: make(map[int]struct{}), } }
接下来,我们定义Init
方法。Init
可以返回一个Cmd
来执行一些初始I/O操作。现在,我们不需要进行任何I/O操作,所以对于命令,我们只返回nil
,这意味着"现在不需要I/O操作"。
func (m model) Init() tea.Cmd { // 只返回`nil`,意味着"现在不需要I/O操作,谢谢"。 return nil }
接下来是update方法。当"有事情发生"时,update函数会被调用。它的工作是查看发生了什么,并相应地返回一个更新后的模型。它还可以返回一个Cmd
来触发更多事件,但现在不用担心这部分。
在我们的例子中,当用户按下向下箭头键时,Update
的工作是注意到向下箭头被按下,并相应地移动光标(或不移动)。
"发生的事情"以Msg
的形式出现,可以是任何类型。消息是某些I/O操作的结果,比如按键、定时器滴答或服务器响应。
我们通常使用类型switch来确定收到了哪种类型的Msg
,但您也可以使用类型断言。
现 在,我们只处理tea.KeyMsg
消息,当按下键时,这些消息会自动发送到update函数。
func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) { switch msg := msg.(type) { // 是按键操作吗? case tea.KeyMsg: // 好的,实际按下的是哪个键? switch msg.String() { // 这些键应该退出程序。 case "ctrl+c", "q": return m, tea.Quit // "上"和"k"键向上移动光标 case "up", "k": if m.cursor > 0 { m.cursor-- } // "下"和"j"键向下移动光标 case "down", "j": if m.cursor < len(m.choices)-1 { m.cursor++ } // "回车"键和空格键(字面上的空格)切换 // 光标所指项目的选中状态。 case "enter", " ": _, ok := m.selected[m.cursor] if ok { delete(m.selected, m.cursor) } else { m.selected[m.cursor] = struct{}{} } } } // 将更新后的模型返回给泡泡茶运行时进行处理。 // 注意我们没有返回命令。 return m, nil }
您可能注意到上面的<kbd>ctrl+c</kbd>和<kbd>q</kbd>与模型一起返回了一个tea.Quit
命令。这是一个特殊命令,它指示泡泡茶运行时退出,结束程序。
最后,是时候渲染我们的UI了。在所有方法中,视图是最简单的。我们查看模型的当前状态,并使用它返回一个string
。那个字符串就是我们的UI!
因为视图描述了应用程序的整个UI,所以您不必担心重绘逻辑之类的东西。泡泡茶会为您处理这些。
func (m model) View() string { // 标题 s := "我们应该在市场上买什么?\n\n" // 遍历我们的选项 for i, choice := range m.choices { // 光标是否指向这个选项? cursor := " " // 无光标 if m.cursor == i { cursor = ">" // 有光标! } // 这个选项是否被选中? checked := " " // 未选中 if _, ok := m.selected[i]; ok { checked = "x" // 已选中! } // 渲染行 s += fmt.Sprintf("%s [%s] %s\n", cursor, checked, choice) } // 页脚 s += "\n按q退出。\n" // 发送UI进行渲染 return s }
最后一步是简单地运行我们的程序。我们将初始模型传递给tea.NewProgram
并让它运行:
func main() { p := tea.NewProgram(initialModel()) if _, err := p.Run(); err != nil { fmt.Printf("哎呀,出错了:%v", err) os.Exit(1) } }
本教程介绍了构建交互式终端UI的基础知识,但在实际应用中,您还需要执行I/O操作。要了解这方面的内容,请查看[命令教程][cmd]。这很简单。
还有几个[泡泡茶示例][examples]可供参考,当然,还有[Go文档][docs]。 [cmd]: http://github.com/charmbracelet/bubbletea/tree/master/tutorials/commands/ [examples]: http://github.com/charmbracelet/bubbletea/tree/master/examples [docs]: https://pkg.go.dev/github.com/charmbracelet/bubbletea?tab=doc
由于 Bubble Tea 应用会接管标准输入和标准输出,你需要在无头模式下运行 delve,然后连接到它:
# 启动调试器 $ dlv debug --headless --api-version=2 --listen=127.0.0.1:43000 . API 服务器监听于:127.0.0.1:43000 # 从另一个终端连接到它 $ dlv connect 127.0.0.1:43000
如果你没有明确提供 --listen
标志,每次运行时使用的端口都会变化,所以传入这个参数可以让调试器更容易从脚本或你选择的 IDE 中使用。
另外,我们传入 --api-version=2
,因为 delve 出于向后兼容的原因默认使用版本 1。然而,delve 建议所有新的开发都使用版本 2,而且某些客户端可能不再支持版本 1。
更多信息,请参阅 Delve 文档。
你不能真的在 Bubble Tea 中将日志记录到标准输出,因为你的 TUI 正忙于占用它!但是,你可以通过在启动 Bubble Tea 程序之前包含类似以下内容来将日志记录到文件:
if len(os.Getenv("DEBUG")) > 0 { f, err := tea.LogToFile("debug.log", "debug") if err != nil { fmt.Println("fatal:", err) os.Exit(1) } defer f.Close() }
要实时查看正在记录的内容,在运行程序的同时,在另一个窗口中运行 tail -f debug.log
。
要查看一些生产环境中的 Bubble Tea 程序,请参阅:
我们很乐意听到您对这个项目的看法。欢迎给我们留言!
Bubble Tea 基于 Evan Czaplicki 等人的 The Elm Architecture 范式和 TJ Holowaychuk 的优秀作品 go-tea。它受到过去许多伟大的字符界面的启发。
Charm 的一部分。
<a href="https://charm.sh/"><img alt="Charm标志" src="https://yellow-cdn.veclightyear.com/835a84d5/0dd6719c-974e-4502-a35f-e97502724013.jpg" width="400"></a>
Charm热爱开源 • Charm loves open source • نحنُ نحب المصادر المفتوحة
字节跳动发布的AI编程神器IDE
Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。
帮助AI理解电脑屏幕 纯视觉GUI元素的自动化解析方案
开源工具通过计算机视觉技术实现图形界面元素的智能识别与结构化处理,支持自动化测试脚本生成和辅助功能开发。项目采用模块化设计,提供API接口与多种输出格式,适用于跨平台应用场景。核心算法优化了元素定位精度,在动态界面和复杂布局场景下保持稳定解析能力。
埃隆·马斯克旗下的人工智能公司 xAI 推出的第三代大规模语言模型
Grok3 是由埃隆·马斯克旗下的人工智能公司 xAI 推出的第三代大规模语言模型,常被马斯克称为“地球上最聪明的 AI”。它不仅是在前代产品 Grok 1 和 Grok 2 基础上的一次飞跃,还在多个关键技术上实现了创新突破。
腾讯自研的混元大模型AI助手
腾讯元宝是腾讯基于自研的混元大模型推出的一款多功能AI应用,旨在通过人工智能技术提升用户在写作、绘画、翻译、编程、搜索、阅读总结等多个领域的工作与生活效率。
Windsurf Editor推出第三次重大更新Wave 3
新增模型上下文协议支持与智能编辑功能。本次更新包含五项核心改进:支持接入MCP协议扩展工具生态,Tab键智能跳转提升编码效率,Turbo模式实现自动化终端操作,图片拖拽功能优化多模态交互,以及面向付费用户的个性化图标定制。系统同步集成DeepSeek、Gemini等新模型,并通过信用点数机制实现差异化的资源调配。
增强编程效率的AI代码编辑器
Cursor作为AI驱动的代码编辑工具,助力开发者效率大幅度提升。该工具简化了扩展、主题和键位配置的导入,可靠的隐私保护措施保证代码安全,深受全球开发者信赖。此外,Cursor持续推出更新,不断优化功能和用户体验。
全面超越基准的 AI Agent助手
Manus 是一款通用人工智能代理平台,能够将您的创意和想法迅速转化为实际成果。无论是定制旅行规划、深入的数据分析,还是教育支持与商业决策,Manus 都能高效整合信息,提供精准解决方案。它以直观的交互体验和领先的技术,为用户开启了一个智慧驱动、轻松高效的新时代,让每个灵感都能得到完美落地。
飞书官方推出的AI知识库 上传word pdf即可部署AI私有知识库
基于DeepSeek R1大模型构建的知识管理系统,支持PDF、Word、PPT等常见文档格式解析,实现云端与本地数据的双向同步。系统具备实时网络检索能力,可自动关联外部信息源,通过语义理解技术处理结构化与非结构化数据。免费版本提供基础知识库搭建功能,适用于企业文档管理和个人学习资料整理场景。
大模型驱动的Excel数据处理工具
基于大模型交互的表格处理系统,允许用户通过对话方式完成数据整理和可视化分析。系统采用机器学习算法解析用户指令,自动执行排序、公式计算和数据透视等操作,支持多种文件格式导入导出。数据处理响应速度保持在0.8秒以内,支持超过100万行数据的即时分析。
DeepSeek开源的专家并行通信优化框架
DeepEP是一个专为大规模分布式计算设计的通信库,重点解决专家并行模式中的通信瓶颈问题。其核心架构采用分层拓扑感知技术,能够自动识别节点间物理连接关系,优化数据传输路径。通过实现动态路由选择与负载均衡机制,系统在千卡级计算集群中维持稳定的低延迟特性,同时兼容主流深度学习框架的通信接口。
最新AI工具、AI资讯
独家AI资源、AI项目落地
微信扫一扫关注公众号