本文介绍在 windows 平台下使用 go 获取终端窗口宽度（列数）和高度（行数）的可靠方案，重点解决 `termbox-go` 初始化遗漏导致返回 `0 0` 的常见问题，并提供完整、健壮的代码示例。
在 Go 中获取终端尺寸（尤其是 Windows 环境）并非直接调用函数即可完成，因为多数终端查询库依赖底层系统调用或初始化上下文。例如，广为人知的 github.com/nsf/termbox-go 库虽跨平台支持良好，但其 termbox.Size() 函数必须在成功调用 termbox.Init() 后才能返回有效值；否则将默认返回 (0, 0) —— 这正是原问题中输出异常的根本原因。
正确做法是：先调用 termbox.Init() 初始化终端状态（该函数会探测并缓存当前窗口尺寸），再调用 termbox.Size() 获取宽高，最后务必调用 termbox.Close() 释放资源并恢复终端原始状态（如光标隐藏、颜色模式等）。以下为完整可运行示例：
package main
import (
"fmt"
"log"
"github.com/nsf/termbox-go"
)
func main() {
if err := termbox.Init(); err != nil {
log.Fatal("无法初始化 termbox：", err)
}
defer termbox.Close() // 确保异常时也能清理
width, height := termbox.Size()
fmt.Printf("终端宽度：%d 列，高度：%d 行\n", width, height)
}
⚠️ 注意事项：
本地项目发布到GitHub的完整工作流助手。自动执行：安全检查（.gitignore、排除敏感.env/凭据文件）、补齐开源文件（LICENSE、.gitignore）、git init/commit/branch、创建远程仓库、首次推送、可选打tag。支持git filter-repo历史敏感信息重写、force push、tag管理。Windows下走Credential Manager自动认证。触发词："发布到GitHub"、"上传到github"、"
- termbox.Init() 是阻塞式调用，在某些受限环境（如 VS Code 集成终端、某些 CI/CD 终端模拟器）中可能失败或超时，建议添加错误处理与超时控制（生产环境可考虑备用方案）；
- 不要省略 defer termbox.Close() —— 缺失会导致终端显示异常（如光标消失、颜色错乱）；
- termbox-go 已归档（archived），官方推荐迁移到更现代的替代库（如 github.com/muesli/termenv 或 golang.org/x/term）；但对纯尺寸查询需求，x/term 目前不提供跨平台窗口尺寸获取 API（仅支持读取输入和控制输出），因此 termbox-go 仍是 Windows 下稳定可用的选择；
- 若需完全免依赖方案，可考虑通过 Windows API 调用 GetConsoleScreenBufferInfo（需 syscall 或 golang.org/x/sys/windows），但跨平台性差且维护成本高，不推荐一般项目采用。
综上，对于 Windows 下 Go 程序获取终端宽度的需求，正确初始化 termbox-go 是最简洁、可靠且经过验证的实践方式。只需牢记“init → size → close”三步流程，即可准确获取实时终端尺寸。
