Go语言：解决终端输入回显导致内容重复显示的问题

问题背景：标准输入与回显困扰

在go语言中，当我们需要从标准输入（os.stdin）读取用户输入时，通常会结合 bufio.newreader 来提高效率和方便性。例如，使用 readstring('\n') 可以读取一行直到换行符。然而，开发者在使用这种方法时，可能会遇到一个常见的困扰：用户输入的内容会显示两次。

让我们看一个典型的代码片段：

package main

import (
    "bufio"
    "fmt"
    "os"
)

func main() {
    fmt.Print("请输入一些文本: ")
    reader := bufio.NewReader(os.Stdin)
    input, err := reader.ReadString('\n')
    if err != nil {
        fmt.Println("读取输入时发生错误:", err)
        os.Exit(1)
    }

    fmt.Printf("你输入的是: %s", input)
}

当运行这段代码并输入 Hello Go 后，你可能会看到以下输出：

请输入一些文本: Hello Go
你输入的是: Hello Go

这里的问题在于，Hello Go 实际上显示了两次。第一次是终端（Shell）自身的行为，它会将用户键入的字符实时回显到屏幕上，这是操作系统层面的功能。第二次则是Go程序通过 fmt.Printf 语句将读取到的 input 变量内容打印出来。这种重复显示在某些场景下，尤其是在要求简洁或处理敏感输入时，会显得冗余和不专业。

解决方案：禁用终端回显

要解决这个问题，我们需要一种方法来读取标准输入，但同时阻止终端进行本地回显。Go语言的标准库中并没有直接提供这样的功能，但 golang.org/x/crypto/terminal 扩展包提供了一个强大的工具：terminal.ReadPassword 函数。

立即学习“go语言免费学习笔记（深入）”；

尽管其名称包含 "Password"，暗示主要用于密码输入，但 ReadPassword 的核心能力是在不进行本地回显的情况下从终端读取一行输入。这意味着当用户输入时，屏幕上不会显示任何字符，直到程序显式地将其打印出来。

terminal.ReadPassword 函数的签名如下：

文小言

百度旗下新搜索智能助手，有问题，问小言。

57

查看详情

func ReadPassword(fd int) ([]byte, error)

它接收一个文件描述符 fd（对于标准输入，通常是 os.Stdin.Fd()），并返回一个 []byte 切片，其中包含了用户输入的数据。值得注意的是，返回的字节切片不包含末尾的换行符 \n。

实践示例：使用 terminal.ReadPassword

首先，你需要确保已经安装了 golang.org/x/crypto/terminal 包：

go get golang.org/x/crypto/terminal

接下来，我们可以修改之前的代码，使用 terminal.ReadPassword 来实现无回显的输入读取：

package main

import (
    "fmt"
    "os"
    "strings" // 用于处理可能的空格和换行符
    "golang.org/x/crypto/terminal" // 导入terminal包
)

func main() {
    fmt.Print("请输入一些文本 (无回显): ")

    // 获取标准输入的文件描述符
    fd := int(os.Stdin.Fd())

    // 检查当前终端是否是交互式终端
    // ReadPassword 仅在交互式终端上有效
    if !terminal.IsTerminal(fd) {
        fmt.Println("\n当前环境不是交互式终端，无法禁用回显。")
        // 在非交互式终端，可以回退到 bufio.NewReader 或其他处理方式
        reader := bufio.NewReader(os.Stdin)
        input, err := reader.ReadString('\n')
        if err != nil {
            fmt.Println("读取输入时发生错误:", err)
            os.Exit(1)
        }
        fmt.Printf("你输入的是: %s", input)
        return
    }

    // 使用 ReadPassword 读取输入，不带本地回显
    byteInput, err := terminal.ReadPassword(fd)
    if err != nil {
        fmt.Println("\n读取输入时发生错误:", err) // 注意：ReadPassword 不会显示用户输入，所以错误信息前加换行
        os.Exit(1)
    }

    // 将字节切片转换为字符串，并去除可能的首尾空白（如Windows上的回车符）
    inputString := strings.TrimSpace(string(byteInput))

    fmt.Printf("\n你输入的是: %s\n", inputString) // ReadPassword 不会回显换行，所以这里手动加一个
}

运行这段代码，当你输入 Hello Go 时，终端将不会显示你键入的字符。当你按下回车键后，程序会一次性打印出结果：

请输入一些文本 (无回显): 
你输入的是: Hello Go

此时，输入内容只显示了一次，达到了我们预期的效果。

注意事项与最佳实践

1. 包路径更新：原始问题可能提及 exp/terminal，但该包已迁移并稳定在 golang.org/x/crypto/terminal。请务必使用新的路径。
2. ReadPassword 的用途：虽然名为 ReadPassword，但其核心功能是禁用回显。因此，任何需要无回显输入的场景（例如，输入验证码、秘密密钥等）都可以考虑使用它。
3. 返回类型：ReadPassword 返回的是 []byte，而不是 string。如果需要以字符串形式处理输入，请务必进行类型转换，例如 string(byteInput)。
4. 换行符处理：ReadPassword 返回的字节切片不包含末尾的换行符 \n。在打印输出时，你可能需要手动添加换行符以保持格式。此外，在某些操作系统（如Windows）上，用户输入回车时可能会产生 \r\n。ReadPassword 会包含 \r。因此，使用 strings.TrimSpace 可以更好地处理潜在的首尾空白字符。
5. 错误处理：始终检查 ReadPassword 返回的错误。例如，如果程序运行在非交互式终端（如管道或文件重定向），ReadPassword 可能会返回错误或行为异常。示例代码中增加了 terminal.IsTerminal(fd) 判断，以提供更健壮的处理。
6. 跨平台兼容性：golang.org/x/crypto/terminal 包在主流操作系统（Linux、macOS、Windows）上都提供了良好的支持，但其底层实现依赖于操作系统的终端API。

总结

通过利用 golang.org/x/crypto/terminal 包中的 ReadPassword 函数，我们可以有效地解决Go语言中从标准输入读取数据时因终端回显导致的重复显示问题。尽管该函数最初设计用于密码输入，但其禁用本地回显的特性使其成为处理任何需要单次、干净输入场景的理想选择。理解其工作原理、正确使用并注意相关细节，将有助于开发者构建更专业、用户体验更佳的命令行应用程序。

以上就是Go语言：解决终端输入回显导致内容重复显示的问题的详细内容，更多请关注php中文网其它相关文章！