Goose终端工具环境变量COLUMNS/ROWS失效问题解析

在终端应用开发中，控制台窗口尺寸的动态获取是一个常见需求。Goose项目近期修复了一个关于环境变量COLUMNS和ROWS在非TTY环境下失效的技术问题，这个案例对于终端应用开发者具有典型参考价值。

问题本质

当Goose CLI工具作为子进程被非TTY环境调用时（例如通过脚本或某些后台进程启动），系统无法自动感知终端实际尺寸。此时虽然父进程通过环境变量传递了COLUMNS=120和ROWS=120参数，但Goose仍默认使用80列的保守宽度值，导致输出格式错乱。

技术背景

传统终端应用通常通过以下方式获取窗口尺寸：

1. 系统调用（如ioctl TIOCGWINSZ）
2. 环境变量（COLUMNS/ROWS）
3. 终端控制序列查询

在非TTY环境下，第一种方式会失效，此时应优先考虑环境变量方案。Node.js生态中process.stdout.columns/rows属性在非TTY环境下可能返回undefined，这正是Goose最初的问题根源。

解决方案

项目组通过显式设置环境变量实现兼容：

process.env.COLUMNS = process.stdout.columns?.toString() || '80';
process.env.ROWS = process.stdout.rows?.toString() || '24';

这种实现具有三层保护：

1. 优先使用标准输出流的实际尺寸
2. 添加可选链操作符防止undefined错误
3. 提供合理的默认值（80x24是传统终端的最小安全尺寸）

开发启示

1. 环境感知：终端工具需要针对TTY/non-TTY环境做差异化处理
2. 降级策略：当主要尺寸获取方式失效时应有备用方案
3. 默认值选择：参考历史惯例（VT100终端标准尺寸）
4. 类型安全：数值到字符串的显式转换避免后续处理异常

该修复方案已被合并到主分支，展示了开源社区如何通过协作解决跨平台兼容性问题。对于开发者而言，这个案例提醒我们在终端工具开发中需要特别注意执行环境的多样性。