Gradle执行程序时终端输入行为异常的原因及解决方法

开发者阿泽

2026-5-21

这个问题我之前在调试Gradle任务时也踩过坑，本质是终端交互模式的差异导致的，咱们来理清楚原因和解决办法：

问题根源

当你直接在Linux终端运行Python脚本时，终端处于交互模式（Interactive Mode），shell会自动处理方向键这类特殊输入——它会把^[[A这类转义序列转换成对应的操作（比如上翻历史命令），不会直接输出到进程里。

但Gradle的Exec任务默认是通过管道来转发输入输出的，没有给启动的Python进程分配伪终端（PTY）。这时候Python进程认为自己不是在交互终端中运行，终端的输入不会经过shell的转义处理，方向键的原始转义序列就直接被Python读取并打印出来了。

解决办法

这里有几个可行的方案，你可以根据自己的场景选择：

方案一：让Gradle为Python进程分配伪终端
Gradle的Exec任务支持通过setPty(true)来分配伪终端，这样Python就会认为自己在交互环境中，终端输入处理会恢复正常。修改你的Gradle任务：
```
task testInput(type: Exec) {
    commandLine 'python', 'test.py'
    standardInput = System.in
    
    // 关键：为进程分配伪终端（仅Linux/macOS适用）
    doFirst {
        if (OperatingSystem.current().isUnix()) {
            execSpec.setPty(true)
        }
    }
}
```
注意这个方法仅在类Unix系统（Linux、macOS）上有效，Windows环境需要另作处理。

方案二：在Python脚本中手动处理终端输入
如果Gradle那边的配置有限制，也可以直接在Python脚本中接管终端，强制启用交互模式的输入处理：

import sys
import tty
import termios

# 保存终端的原始配置，避免退出后终端异常
old_term_settings = termios.tcgetattr(sys.stdin)
try:
    # 设置终端为原始模式，解析特殊输入（比如方向键）
    tty.setraw(sys.stdin.fileno())
    print('input value')
    # 读取输入（这里用readline会自动处理历史记录和方向键）
    value = sys.stdin.readline()
    print('your value', value.strip())
finally:
    # 恢复终端的原始设置
    termios.tcsetattr(sys.stdin, termios.TCSADRAIN, old_term_settings)

这个方法的好处是不依赖Gradle配置，直接在Python层面解决问题，但要确保终端设置能被正确恢复，否则退出脚本后终端可能会出现输入不显示等异常。

方案三：用script命令包装Python调用
在Linux下，你可以用script命令来模拟一个完整的终端环境，把Python脚本放在里面运行。修改Gradle任务的命令：
```
task testInput(type: Exec) {
    // 用script命令创建伪终端，-q静默模式，/dev/null忽略日志文件
    commandLine 'bash', '-c', 'script -q -c "python test.py" /dev/null'
    standardInput = System.in
    redirectErrorStream = true
}
```
script命令会自动处理终端交互的细节，让Python进程的输入输出和直接在终端运行时一致。

内容的提问来源于stack exchange，提问作者user2667549