如何获取IntelliJ运行输出控制台的终端宽度

问题根因 #

点击IntelliJ系列IDE的运行按钮启动Python脚本时，默认会把程序的标准输出、错误输出绑定到IDE输出面板的无名管道，不存在shutil.get_terminal_size交互所需的标准伪终端（PTY）句柄。该方法的核心检测逻辑是直接从绑定的终端设备文件读取尺寸参数，当检测不到有效终端时，就会自动返回80列的固定兜底值。
脚本在GNOME Terminal、Terminator或者IntelliJ内置终端中能正常返回动态变化的尺寸，本质是这些环境会给运行中的程序分配真实的终端句柄，能够响应系统层面的终端尺寸查询调用。

可落地的解决方式 #

方式1：开启运行配置的终端模拟适配 #

IntelliJ、PyCharm这类产品在Python运行配置中内置了对应兼容选项，配置后即可让直接点击运行按钮启动的程序获得和内置终端完全一致的运行环境：

• 打开目标Python运行配置的设置面板，在执行选项分组中找到在输出控制台中模拟终端的勾选选项
• 勾选保存后重新运行脚本，shutil.get_terminal_size即可正常读取到当前IDE控制台的实际宽度，当拖动调整IDE控制台的面板尺寸时，方法返回的列数也会同步动态更新

注意：该配置是单运行配置维度生效的，新增的运行配置需要单独勾选对应选项，不会自动继承全局设置。

方式2：自定义逻辑兜底获取控制台尺寸 #

如果业务场景不适合开启终端模拟（比如需要结构化捕获程序输出做自动化分析），可以在代码中增加适配逻辑：

• 检测到当前运行环境无有效终端句柄时，不直接使用shutil.get_terminal_size返回的80列兜底值，可通过预设环境变量、读取IDE控制台的固定宽度配置的方式获取实际面板尺寸
• 也可以在必要时通过标准终端控制序列和IDE控制台建立交互，手动查询控制台可支持的最大输出宽度

常见兼容说明 #

部分2022.3版本之前的旧版IntelliJ/PyCharm存在伪终端模拟的兼容缺陷，即使勾选了对应选项，Python侧的shutil.get_terminal_size依然可能返回固定兜底值，升级到官方正式发布的稳定版本即可解决该问题。

内容的提问来源于stack exchange，提问作者Lydia van Dyke