如何在Swift中结合PTY使用Foundation.Process实现子进程终端级交互

架构老林

2026-10-7

问题根因

你遇到的输入无响应问题主要由两个核心原因导致：

默认终端处于规范模式，输入内容会被系统缓存直到用户按下回车键才会提交给你的主程序，同时回显、信号处理等默认终端行为会干扰PTY子进程的输入处理
你使用Logger输出PTY返回内容、未及时关闭冗余句柄、未做终端状态还原的操作也会导致异常

推荐实现方案

以下实现完全基于系统原生Foundation和Darwin模块，不需要引入自定义C/C++代码，可让子进程表现与原生终端运行完全一致。

1. 前置依赖导入

import Foundation
import Darwin

2. 终端状态管理逻辑

你需要先保存当前终端的原始状态，在启动子进程时切换为原始模式，进程退出后还原，避免终端状态异常：

// 全局保存原始终端属性
private var originalTermios = termios()
tcgetattr(STDIN_FILENO, &originalTermios)

private func enableRawMode() {
    var rawMode = originalTermios
    // 关闭行缓冲、回显、默认信号处理等终端默认行为
    rawMode.c_lflag &= ~(tcflag_t(ECHO | ICANON | ISIG | IEXTEN))
    rawMode.c_iflag &= ~(tcflag_t(BRKINT | ICRNL | INPCK | ISTRIP | IXON))
    rawMode.c_cflag &= ~(tcflag_t(CSIZE | PARENB))
    rawMode.c_cflag |= CS8
    rawMode.c_oflag &= ~(tcflag_t(OPOST))
    // 配置输入触发规则：单字节输入立即返回，无超时
    rawMode.c_cc[VMIN] = 1
    rawMode.c_cc[VTIME] = 0
    tcsetattr(STDIN_FILENO, TCSANOW, &rawMode)
}

3. Process与PTY绑定逻辑

let process = Process()
// 替换为你的可执行文件路径与参数
process.executableURL = URL(fileURLWithPath: "/usr/bin/env")
process.arguments = ["xcodes", "login"]

var parentFD: Int32 = 0
var childFD: Int32 = 0
guard Darwin.openpty(&parentFD, &childFD, nil, nil, nil) != -1 else {
    fatalError("PTY创建失败")
}

let parentHandle = FileHandle(fileDescriptor: parentFD, closeOnDealloc: true)
let childHandle = FileHandle(fileDescriptor: childFD, closeOnDealloc: true)

process.standardInput = childHandle
process.standardOutput = childHandle
process.standardError = childHandle

// 进程终止后自动还原终端状态
process.terminationHandler = { _ in
    tcsetattr(STDIN_FILENO, TCSANOW, &originalTermios)
    exit(process.terminationStatus)
}

do {
    try process.run()
    // 子进程启动后父进程立即关闭子端句柄，避免资源泄漏导致输入卡住
    childHandle.closeFile()
    enableRawMode()
} catch {
    fatalError("进程启动失败: \(error)")
}

4. 输入输出转发逻辑

// PTY输出转发到当前终端标准输出
parentHandle.readabilityHandler = { handle in
    let outputData = handle.availableData
    guard !outputData.isEmpty else {
        // PTY已关闭，子进程退出
        tcsetattr(STDIN_FILENO, TCSANOW, &originalTermios)
        exit(0)
    }
    // 直接写入标准输出，不要用Logger/print，避免破坏原输出格式
    FileHandle.standardOutput.write(outputData)
}

// 当前终端输入转发到PTY父端
FileHandle.standardInput.readabilityHandler = { handle in
    let inputData = handle.availableData
    guard !inputData.isEmpty else { return }
    do {
        try parentHandle.write(contentsOf: inputData)
    } catch {
        // 写入失败说明PTY已断开，退出程序
        tcsetattr(STDIN_FILENO, TCSANOW, &originalTermios)
        exit(0)
    }
}

5. 保活主进程

// 阻塞主进程，避免直接退出
RunLoop.main.run()

可选增强功能

如果需要同步终端窗口大小变化到子进程，可添加信号监听逻辑：

signal(SIGWINCH, { _ in
    var winSize = winsize()
    ioctl(STDIN_FILENO, TIOCGWINSZ, &winSize)
    ioctl(parentFD, TIOCSWINSZ, &winSize)
})

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