lipgloss是终端排版系统，非简单着色工具；需注意ANSI支持、中文宽度计算、换行控制、样式并发安全及窗口缩放响应。
lipgloss 不是“加个颜色就完事”的玩具库，它是一套终端排版系统——用错地方或只当 color 替代品，反而会让输出错位、换行异常、中文对齐崩坏。
为什么 lipgloss.NewStyle().Foreground(lipgloss.Color("9")).Render("text") 在某些终端里不显色
常见错误现象：本地 VS Code 终端显示红色，但 CI 日志里变成乱码或纯白；Docker 容器中运行时颜色全丢；Windows CMD 下完全无反应。
- ANSI 颜色启用依赖终端虚拟终端（Virtual Terminal）支持，旧版 Windows CMD 默认关闭，
lipgloss不会主动调用EnableVirtualTerminalProcessing—— 这和github.com/fatih/color的自动初始化不同 - CI 环境（如 GitHub Actions）通常不分配 TTY，
os.Stdout.Fd()不是终端设备，lipgloss会静默降级为无样式输出（不报错） - 如果你在重定向场景下使用（如
./mycli > out.txt），lipgloss默认不检测是否为 TTY，也不会自动禁用颜色 —— 导致文件里混入 ANSI 控制符 - 正确做法是显式控制：
lipgloss.NoColor = true（全局）或用lipgloss.AdaptiveColor配合环境判断，而非依赖自动探测
Padding 和 Width 组合后中文显示被截断或错位
典型表现：设置了 Width(20) 和 Padding(1)，但含中文的字符串渲染后右侧被砍掉，或左右不对称。
-
lipgloss计算宽度时默认按 rune 数（即 Unicode 码点数），不是视觉宽度；一个中文字符占 2 个终端列宽，但被算作 1 个 rune -
Padding是基于字符数的内边距，不是像素或列宽，所以Padding(1)对中文和 ASCII 字符效果一致，但视觉上“左边空一格、右边空一格”在中文场景下明显不对称 - 没有内置中文宽度补偿机制；
lipgloss不像tablewriter那样调用runewidth.StringWidth类库做适配 - 临时解法：手动用
runewidth.StringWidth计算真实列宽，再反推 padding 值；长期建议避免在固定Width场景混用中英文，或改用Align+ 自由宽度布局
和 bubbletea 混用时 View() 返回值换行异常
现象：在 bubbletea 的 View() 方法里拼接多个 lipgloss.Style.Render()，结果段落间多出空行，或最后一行总被吞掉。
立即学习“go语言免费学习笔记（深入）”；
-
lipgloss.Style.Render()返回的是带换行符的完整字符串（末尾含\n），而bubbletea的View()期望返回“可直接写入终端的原始内容”，多一个\n就多一行空白 - 常见错误写法：
return headerStyle.Render("HEAD") + "\n" + bodyStyle.Render("BODY")→ 实际输出是"HEAD\n\nBODY\n"，中间空行 - 正确方式是去掉冗余换行：
return headerStyle.Render("HEAD")[:len(headerStyle.Render("HEAD"))-1] + "\n" + bodyStyle.Render("BODY")[:len(bodyStyle.Render("BODY"))-1]，或更安全地用strings.TrimSuffix - 更推荐做法：统一用
lipgloss.JoinVertical或lipgloss.JoinHorizontal组合，它们内部已处理换行逻辑
想复用样式但 lipgloss.NewStyle() 每次都新建，性能有问题吗
问题本质不是性能瓶颈，而是状态污染风险 —— 多 goroutine 并发调用同一 style 实例时，链式调用会修改原对象。
-
lipgloss.Style是值类型（struct），但其内部字段含指针（如*color.Color），NewStyle()返回的是可变对象，不是不可变样式实例 - 错误模式：
var base = lipgloss.NewStyle().Bold(true); go func(){ fmt.Println(base.Foreground(lipgloss.Color("2")).Render("x")) }()—— 若其他 goroutine 同时调用base.Background(...)，可能影响前者的渲染结果 - 安全做法：定义样式常量时用函数封装，每次调用都生成新实例：
func Success() lipgloss.Style { return lipgloss.NewStyle().Foreground(lipgloss.Color("2")) } - 别试图缓存
Style实例做“复用”，它的设计意图就是轻量构造；真正要优化的是字符串拼接和Render()调用频次，不是 style 创建本身
最易被忽略的一点：lipgloss 的 Align、Width、MaxWidth 全部依赖终端当前列宽（termenv.Width()），而这个值在窗口缩放时不会自动更新 —— 如果你的 CLI 支持 resize，必须监听 SIGWINCH 并手动刷新布局，否则对齐立刻失效。
