本文介绍在 Go 编写的命令行工具中安全获取用户密码的两种主流方法：使用系统 stty 命令临时关闭终端回显，或引入轻量级第三方库 gopass 实现跨平台、无回显的密码输入。
本文介绍在 go 编写的命令行工具中安全获取用户密码的两种主流方法：使用系统 `stty` 命令临时关闭终端回显，或引入轻量级第三方库 `gopass` 实现跨平台、无回显的密码输入。
在开发 Go 命令行工具（CLI）时，若需交互式获取用户密码（如登录认证、配置写入等），绝不能直接使用 fmt.Scanln 或 bufio.NewReader(os.Stdin).ReadString('\n') —— 这会导致密码明文显示在终端上，严重违反安全最佳实践。
✅ 推荐方案一：使用 gopass（推荐，简洁可靠）
gopass 是一个成熟、轻量、纯 Go 实现的密码读取库，支持 Linux/macOS/Windows（通过 syscall 或 golang.org/x/sys 抽象），自动处理终端属性切换，无需手动调用系统命令。
安装：
go get github.com/howeyc/gopass
使用示例：
package main
import (
"fmt"
"github.com/howeyc/gopass"
)
func main() {
fmt.Print("Username: ")
var username string
fmt.Scanln(&username)
fmt.Print("Password: ")
password, err := gopass.GetPasswd()
if err != nil {
panic("Failed to read password: " + err.Error())
}
// ✅ 密码已安全读取，未回显、未缓存到命令历史
fmt.Printf("\nLogin as %s successful.\n", username)
// 后续可加密存储至 $HOME/.config/myapp/config.json 等位置
}
⚠️ 注意：gopass.GetPasswd() 返回的是 []byte（非 string），建议立即用于哈希/加密，避免长期持有明文；使用后可调用 gopass.Clear()（v0.1+）主动清零内存。
✅ 推荐方案二：手动控制终端回显（仅限 Unix-like 系统）
适用于无法引入外部依赖的场景。原理是通过 os/exec 调用 stty -echo 关闭输入回显，读取后恢复 stty echo：
package main
import (
"fmt"
"os/exec"
"bufio"
"os"
"strings"
)
func readPasswordUnix() (string, error) {
// 关闭回显
if err := exec.Command("stty", "-echo").Run(); err != nil {
return "", err
}
defer func() { _ = exec.Command("stty", "echo").Run() }() // 恢复回显（即使出错也应尝试）
reader := bufio.NewReader(os.Stdin)
line, err := reader.ReadString('\n')
if err != nil {
return "", err
}
return strings.TrimSpace(line), nil
}
func main() {
fmt.Print("Password: ")
pwd, err := readPasswordUnix()
if err != nil {
panic(err)
}
fmt.Println("\nPassword received (hidden).")
}
❗ 限制：该方法在 Windows 上不可用（stty 非原生命令），且存在竞态风险（如程序 panic 未执行 defer 恢复，导致终端持续无回显）。生产环境强烈建议优先使用 gopass。
? 最佳实践总结
- 永远避免 fmt.Scanf("%s") 或 bufio.ReadBytes 直接读密码；
- 优先选用 gopass：跨平台、健壮、社区维护活跃（截至 2024 年仍兼容 Go 1.21+）；
- 若必须自制逻辑，请结合 golang.org/x/term（Go 1.19+ 标准库新增）——它提供了更安全、更现代的替代方案：
import "golang.org/x/term" // ... password, err := term.ReadPassword(int(os.Stdin.Fd()))
- 密码读取后，应立即进行单向哈希（如 bcrypt）或密钥派生（如 scrypt），切勿以明文形式持久化或日志输出。
通过以上任一方式，你的 Go CLI 即可像 sudo、git credential 或 ssh 那样，实现专业、安全、无感的密码输入体验。
