tmux 在 vscode 中锁死 columns 是因不监听 resize 事件且无 ipc 通道,需手动触发刷新或重启会话;自动重载、配置变更或 vscode 设置均无效。

为什么 tmux 会把 VSCode 终端的 COLUMNS 值锁死?
VSCode 集成终端启动 tmux 后,COLUMNS 环境变量不再随面板缩放动态更新,而是固定为 tmux 会话首次创建时的宽度(通常是 80 或 120)。这导致 ls -la、jq、git status 等命令输出强制折行或截断——不是终端没空间,是 tmux 根本“不知道”你拖大了面板。
根本原因在于:tmux 自己维护一套窗口尺寸缓存,它不监听 VSCode 终端的 resize 事件;而 VSCode 的集成终端又不会主动向已运行的 tmux 进程发送 resize-pane 指令。
- 验证方式:在 tmux 内执行
echo $COLUMNS,再拖动 VSCode 终端边缘,值不变 - 对比:直接在 VSCode 终端里不进 tmux,
COLUMNS会实时响应拖拽 - 注意:
stty size返回的也是 tmux 缓存值,不是真实像素宽
如何让 tmux 在 VSCode 里正确响应终端缩放?
必须绕过 tmux 的静态尺寸缓存机制,靠外部触发重绘。最可靠的方式是手动通知 tmux 刷新尺寸,而不是等它自己探测。
- 在 tmux 会话中按
Ctrl+b,松开后立刻按Alt+Up(或Ctrl+Up)——这是 tmux 默认的resize-pane -U快捷键,能强制重读终端尺寸 - 更通用的方法:先退出 tmux(
Ctrl+b→d),再用 VSCode 终端菜单「Terminal → New Terminal」重建会话,新会话会读取当前真实COLUMNS - 自动化补救:在 tmux 配置文件
~/.tmux.conf中加一行set -g automatic-reload on,但仅对配置文件变更生效,不解决 resize 问题
VSCode + tmux 下 JSON / 表格类输出仍折行怎么办?
即使 COLUMNS 正确,某些工具(如 jq、ps)默认按终端宽度硬截断,而非流式换行。它们依赖的是 stdout 的 isatty() 判断,而 tmux 会干扰这一判断。
- 临时修复:对
jq加--color=always强制启用 ANSI 输出,再配合less -R查看:jq '.' data.json | less -R - 绕过 tmux 尺寸限制:用
stty cols $(tput cols)手动同步,但需在每次 resize 后执行(无法自动) - 终极规避:不用 tmux 直接跑命令,或改用
tmux attach -r(带-r参数可重新同步尺寸,但需提前启用set -g aggressive-resize on)
别信 “tmux 自动适配” —— VSCode 的 resize 事件根本传不到 tmux 进程里
VSCode 的终端底层是 Electron 渲染器,它只负责把字符画到画布上;tmux 是独立进程,运行在 shell 子进程中,两者之间没有 IPC 通道。所谓“自动适配”只存在于原生终端(如 gnome-terminal)+ tmux 的组合里,因为它们共享 tty 层的 SIGWINCH 信号。
这意味着:任何试图通过 VSCode 设置(比如 terminal.integrated.fontSize 或 workbench.panel.defaultHeight)来“驱动” tmux 重绘尺寸的操作,都是无效的。你调高字体,COLUMNS 不变;你拉宽面板,tmux 仍按老宽度排版。
真正起作用的只有两个动作:手动触发 tmux 尺寸刷新,或者彻底重启 tmux 会话。其他所有“自动”方案,要么失效,要么依赖未公开的 Electron API,不稳定。











