Go 命令行输入密码怎么关闭字符回显

Go 命令行程序需要读取密码时，不要直接用 fmt.Scanln 或 bufio.Scanner 接收交互输入：它们会让用户输入的字符直接显示在终端。更合适的做法是把标准输入的文件描述符交给 golang.org/x/term 的 ReadPassword。

ReadPassword 会在终端关闭本地回显，按回车后返回不带换行符的字节切片。它只解决“输入时是否显示”，不会替你完成密码校验、日志脱敏或密钥生命周期管理。

一、最小方案：把终端文件描述符交给 ReadPassword

安装依赖后，只需要获取 os.Stdin 的文件描述符。示例中的 fmt.Println() 很重要：密码输入期间回车本身也不会回显，所以读取结束后要主动换行，避免后续提示符贴在同一行。

package main

import (
	"fmt"
	"os"

	"golang.org/x/term"
)

func main() {
	fmt.Print("密码: ")
	password, err := term.ReadPassword(int(os.Stdin.Fd()))
	fmt.Println() // 隐藏输入不会显示回车，读取后补一行
	if err != nil {
		fmt.Fprintf(os.Stderr, "读取密码失败: %v\n", err)
		return
	}

	// 这里只演示长度，真实程序应直接使用密码完成认证。
	fmt.Printf("已读取 %d 个字节\n", len(password))
	for i := range password {
		password[i] = 0 // 用完后覆盖切片，减少残留时间
	}
}

这个 API 的参数是文件描述符，不是 *os.File。在常见的交互式终端中，int(os.Stdin.Fd()) 就是标准输入对应的描述符。返回的 []byte 不包含 \n，因此不要再用 strings.TrimSpace 作为“去换行”的必要步骤；那可能误删用户密码开头或结尾本来就有意义的空格。

二、ReadPassword 与普通输入方案怎么选

隐藏回显不是所有命令行输入都需要。把输入方式按任务拆开，代码会更容易维护。

如果程序只是读取用户名、文件路径或搜索词，普通的 bufio.Reader 或 Scanner 更直观。若程序已经用 term.NewTerminal 管理提示符和编辑行为，可以调用其 ReadPassword(prompt) 方法；官方文档说明，这个调用会临时改变提示并在读取期间关闭回显。

三、错误处理和非交互输入不能省略

在 IDE 的运行面板、CI、管道或重定向中，标准输入未必连接到终端。此时继续调用隐藏输入，可能得到错误，也可能让自动化任务等待一个永远不会到来的输入。可以先做分流：

fd := int(os.Stdin.Fd())
if !term.IsTerminal(fd) {
	// 非终端场景改用受控的环境变量、密钥文件或上游注入机制。
	fmt.Fprintln(os.Stderr, "当前输入不是交互式终端")
	return
}

password, err := term.ReadPassword(fd)
fmt.Println() // 只在终端输入路径补换行
if err != nil {
	// 不要把底层错误伪装成“密码为空”。
	fmt.Fprintf(os.Stderr, "无法读取交互式密码: %v\n", err)
	return
}

这里的判断不是安全认证本身，而是运行环境判断。非终端任务可以选择从标准输入读取预先注入的内容，但要明确约定权限、生命周期和日志策略，不能把密码拼到命令行参数中，因为命令历史和进程列表可能暴露参数。

四、读取完成后如何减少密码残留

关闭字符回显只能防止旁观者看到屏幕上的输入，不能防止程序主动打印、记录或长期保存密码。认证成功后应尽快丢弃明文，错误信息也只写“认证失败”或底层必要信息，避免把密码、长度以外的敏感内容写进日志。

示例中的字节覆盖可以减少切片中的残留，但不等于强保证：编译器、运行时或其他副本仍可能存在短暂数据。更重要的边界是，不把密码放进 URL、命令行参数、结构化日志和 panic 文本；需要传给认证库时也尽量缩短作用域。

因此可以这样做一个发布前检查：交互终端输入使用 term.ReadPassword；所有返回值都检查 error；读取后补换行；认证逻辑不打印原文；非终端运行有明确替代入口；使用结束后覆盖可控的字节切片。

常见问题

ReadPassword 返回的内容包含回车吗？

不包含。官方文档明确说明返回切片不含 \n，程序需要自己决定是否输出换行，但不要因此擅自裁剪密码内容。

能不能只用 fmt.Scanln 读取密码？

可以读取文本，却不能关闭终端本地回显。只要输入属于密码或令牌，就应改用终端密码 API，并另外处理日志和内存中的敏感数据。