# 使用 Charmbracelet 构建迷人的 TUI ## 快速路由器 **你在建造什么？** 背景 |解决方案 |参考 ---|---|--- **Shell/Bash 脚本** |口香糖、VHS、模组、冷冻 | → 外壳脚本 **转到 CLI/TUI** |珍珠奶茶+唇彩| → 去途易 **可通过 SSH 访问的应用程序** |心愿+珍珠奶茶| → 基础设施 **录制演示** |录像带 | → 外壳脚本 **测试 TUI** |测试| → 基础设施 ** ** ## 对于 Shell 脚本 **不需要 Go。** Gum 为您提供所有 UI 原语。酿造安装口香糖 ### 基本口香糖命令 # 输入 NAME=$(口香糖输入--占位符“你的名字”) # 选择（单个） COLOR=$(口香糖选择“红”“绿”“蓝”) # 选择（多） ITEMS=$(口香糖选择--无限制“a”“b”“c”) # 模糊过滤器（来自标准输入） BRANCH=$(git 分支 | 口香糖过滤器) # 确认口香糖确认“继续？” && 回显“是” # 微调器口香糖旋转 --标题“正在工作...”--长命令 # 样式输出口香糖样式 --border rounded --padding "1 2" "Hello" # 文件选择器 FILE=$(口香糖文件.) ### 快速秘诀：Git 提交 TYPE=$(口香糖选择“壮举”“修复”“文档”“重构”) MSG=$(口香糖输入--占位符“提交消息”) 口香糖确认“承诺？” && git commit -m "$TYPE: $MSG" ### VHS 快速入门录制终端→GIF：酿造安装vhs 猫 > demo.tape << 'EOF' 输出演示.gif 设置主题“卡布奇辛摩卡” 输入“回声你好” 输入睡眠1秒 EOF VHS 演示磁带 ### 其他 Shell 工具工具|安装 |单线 ---|---|--- **模组** | `brew 安装 mods` | `git diff |模组“审查这个”` **发光** | `brew 安装发光` | `发光自述文件.md` **冻结** | `brew 安装冻结` | `冻结代码.go -o 截图.png` **[完整的 Shell 参考 →]()** ** ** ## 对于 Go 应用程序 ### 即时开始去获取 github.com/charmbracelet/bubbletea \ github.com/charmbracelet/lipgloss ### 最小 TUI（复制并运行）包主导入（ “FMMT” 茶“github.com/charmbracelet/bubbletea” “github.com/charmbracelet/lipgloss” ） var 高亮 = lipgloss.NewStyle().Foreground(lipgloss.Color("212")).Bold(true) 类型模型结构体{ 项目[]字符串光标整数 } func (m 模型) Init() tea.Cmd { return nil } func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) { 切换消息 := 消息。(类型) { 案例茶.KeyMsg: 开关 msg.String() { 案例“q”，“ctrl+c”：返回米，茶。退出案例“向上”，“k”：如果 m.cursor > 0 { m.cursor-- } 案例“向下”，“j”： if m.cursor < len(m.items)-1 { m.cursor++ } 案例“输入”： fmt.Printf("选定: %s\n", m.items[m.cursor]) 返回米，茶。退出 } } 返回 m，零 } func (m 模型) View() 字符串 { s：=“” 对于 i，item := 范围 m.items { 如果 i == m.cursor { s += 高亮.Render("▸ "+item) + "\n" } 否则{ s += " " + 项目 + "\n" } } return s + "\n(↑/↓移动，进入选择，q退出)" } 函数主() { m := model{items: []string{"选项 A", "选项 B", "选项 C"}} 茶.NewProgram(m).Run() } ### 库备忘单需要|图书馆 |示例 ---|---|--- TUI框架| `珍珠奶茶` | `tea.NewProgram(model).Run()` 组件| '气泡' | `list.New()`、`textinput.New()` 造型 | `唇彩` | `style.Foreground(lipgloss.Color("212"))` 表格（简单）| `哈` | `huh.NewInput().Title("名称").Run()` 降价| ‘魅力’ | `glamour.Render(md, "dark")` 动画| `口琴` | `口琴.NewSpring()` ### 快速模式 **样式输出（无 TUI）：** 风格 := lipgloss.NewStyle().Foreground(lipgloss.Color("205")).Bold(true) fmt.Println(style.Render("你好！")) **简单表格（无 TUI）：** 变量名称字符串 huh.NewInput().Title("你的名字？").Value(&name).Run() **确认：** var 好的布尔 huh.NewConfirm().Title("删除？").Value(&ok).Run() **[完整 Go TUI 参考 →]()** **[组件 API →]()** **[高级模式→]()** ** ** ## 对于基础设施 ### 愿望：SSH 应用程序通过 SSH 提供 TUI： s, _ := Wish.NewServer( 希望.WithAddress(":2222"), Wish.WithHostKeyPath(".ssh/key"), 希望.WithMiddleware( bubbletea.中间件（处理程序），日志记录.Middleware(), ), ） s.ListenAndServe() 连接：`ssh localhost -p 2222` ### 其他基础设施工具|目的|安装 ---|---|--- **软服务** |自托管 Git | `brew 安装软服务` **流行** |发送电子邮件 | `酿造安装流行` **滑冰** |键值存储 | `酿造安装滑板` **融化** | SSH 密钥备份 | `酿造安装融化` **愿望清单** | SSH网关| `去安装 github.com/charmbracelet/wishlist` ### 测试 TUI tm := teatest.NewTestModel(t, 模型) tm.Send(tea.KeyMsg{类型：tea.KeyEnter}) tm.Type("你好") teatest.WaitFor(t, tm, func(b []byte) bool { 返回 strings.Contains(string(b), "expected") }) **[完整基础设施参考 →]()** ** ** ## 决策指南是shell脚本吗？ ├─ 是 → 使用口香糖 │ 需要录音吗？ → 录像带 │ 需要人工智能吗？ → 模组 │ └─ 否（Go 应用程序） │ ├─ 只需要样式输出？ │ └─ 仅唇彩（不含珍珠奶茶） │ ├─ 需要简单的提示/表格？ │ └─ 呵呵独立 │ ├─ 需要完整的交互式 TUI？ │ └─ 珍珠奶茶+泡泡+唇彩 │ └─ 需要 SSH 访问吗？ └─ 心愿+珍珠奶茶 ** ** ## 何时不使用魅力 * **输出通过管道传输：** `mytool | grep` → 纯文本 * **CI/CD:** 无终端 → 使用标志/环境变量 * **一个简单的提示：** 也许 `fmt.Scanf` 就可以了 **逃生舱口：** if !term.IsTerminal(os.Stdin.Fd()) || os.Getenv("NO_TUI") != "" { 运行普通模式（）返回 } ** ** ## 所有参考文献参考|内容 ---|--- [Shell 脚本]() |口香糖、VHS、模组、冷冻、发光 - 完整 [转到 TUI]() |珍珠奶茶模式、调试、反模式 [基础设施]() |希望，软冰淇淋，茶测试，x/学期 [组件目录]() |所有 Bubbles 组件 API [高级模式]() |主题、布局、制作架构

打造魅力家园

包含技能