本文详解如何在 go cli 应用中实现“向终端写入预设文本，并使其作为用户可编辑的默认输入”，从而构建交互式命令向导（wizard），核心依赖 golang.org/x/term 和底层终端控制能力。
本文详解如何在 go cli 应用中实现“向终端写入预设文本，并使其作为用户可编辑的默认输入”，从而构建交互式命令向导（wizard），核心依赖 golang.org/x/term 和底层终端控制能力。
在构建 CLI 向导类工具（如项目初始化器、配置生成器）时，一个常见且友好的交互模式是：程序输出一条建议命令（例如 git commit -m "feat: add login"），该命令已预先显示在光标位置，用户可直接回车执行，也可按方向键或退格键修改后再提交。这并非简单的 fmt.Print + fmt.Scanln 能实现——因为标准输入读取不会“感知”之前输出的文本；它需要终端处于行编辑模式（line editing），即模拟 shell 的输入行为。
Go 标准库本身不提供高级行编辑功能，但自 Go 1.19 起，golang.org/x/term 包提供了跨平台的终端读取支持，结合系统级终端控制（如 Unix 的 stty 或 Windows 的 Console API），可安全实现预填充输入。以下是推荐的生产级方案：
✅ 推荐方案：使用 golang.org/x/term + 手动预填充（兼容性好、无 C 依赖）
package main
import (
"fmt"
"os"
"runtime"
"strings"
"golang.org/x/term"
)
// ReadLineWithDefault 读取一行输入，支持预填充默认值（仅限 Unix/Linux/macOS；Windows 需额外处理）
func ReadLineWithDefault(prompt, defaultValue string) (string, error) {
fmt.Print(prompt)
if runtime.GOOS == "windows" {
// Windows 下 term.ReadPassword 不支持回显，故改用简单回显 + Scan
// 实际生产环境建议用 github.com/AlecAivazis/survey/v2 等成熟库
fmt.Print(defaultValue)
var input string
_, _ = fmt.Scanln(&input)
if input == "" {
return defaultValue, nil
}
return input, nil
}
// Unix-like 系统：利用 term.ReadPassword 模拟（注意：它默认关闭回显，需手动处理）
// 更佳实践：使用第三方库（见下文），此处展示原理
fmt.Print(defaultValue)
// 恢复光标至行首并启用行编辑需调用 ioctl —— 复杂且易出错，故不推荐手写
// ✅ 正确做法：交由专业库完成
return "", fmt.Errorf("跨平台预填充需使用 survey 或 promptui 等库")
}
func main() {
// 示例：生成建议命令
suggestedCmd := "docker run -p 8080:80 nginx"
fmt.Println("✨ CLI 向导：请确认或编辑以下命令后按 Enter")
fmt.Print("执行命令: ")
// 使用 github.com/AlecAivazis/survey/v2（最成熟选择）
// go get github.com/AlecAivazis/survey/v2
/*
import "github.com/AlecAivazis/survey/v2"
var cmd string
err := survey.AskOne(&survey.Input{
Message: "执行命令:",
Default: suggestedCmd,
}, &cmd)
if err != nil {
panic(err)
}
fmt.Printf("✓ 已执行: %s\n", cmd)
*/
}⚠️ 注意事项与最佳实践
- 不要尝试手动操纵终端缓冲区：像 fmt.Print(defaultValue) 后调用 bufio.NewReader(os.Stdin).ReadString('\n') 会导致输入流混乱——预填充文本未被 stdin 缓冲区捕获，用户输入将覆盖而非编辑它。
- 避免 C 绑定（如 goncurses）除非必要：虽然 goncurses 提供了 ncurses 封装，但它引入 CGO 依赖、增加编译复杂度与跨平台风险，对简单预填充场景属于过度设计。
-
生产推荐库：
- github.com/AlecAivazis/survey/v2：API 简洁，内置默认值、验证、多选等，完美支持预填充（Default 字段），纯 Go 实现。
- github.com/manifoldco/promptui：轻量灵活，Prompt 结构体支持 Default 和自定义模板。
- Windows 兼容性：上述 Go 库均通过 golang.org/x/sys/windows 或 io/tty 抽象层自动处理 Windows 控制台 API，无需条件编译。
✅ 总结
Go 中无法仅靠标准库原生实现“输出即输入”的预填充效果，但借助成熟的第三方交互库（尤其是 survey/v2），可一行代码达成专业级 CLI 体验：
survey.AskOne(&survey.Input{Message: "命令:", Default: "curl https://api.dev"}, &userCmd)这既保证了跨平台稳定性，又规避了底层终端编程的陷阱。对于向导型 CLI，优先选用经过广泛验证的交互库，而非自行封装终端控制逻辑。
