0

0

使用Golang实现一个简单的命令行备忘录 Go语言Flag包参数解析

P粉602998670

P粉602998670

发布时间:2026-02-26 10:26:02

|

620人浏览过

|

来源于php中文网

原创

flag.string 返回指针因需在解析时直接修改变量内存地址内容;传值无法生效,解引用用*msg;子命令需手动切分os.args并提前提取,在flag.parse前初始化独立flagset。

使用golang实现一个简单的命令行备忘录 go语言flag包参数解析

为什么 flag.String 返回的是指针而不是值

因为 flag 包需要在解析命令行时直接修改变量内存地址里的内容,如果传值,函数内部改了也没用。你声明一个 string 变量,然后用 flag.String 绑定它,本质是让 flag 在解析完后把结果写进那个变量的地址里。

常见错误:写成 msg := flag.String("msg", "", "备忘内容"),然后直接用 msg 当字符串拼接或打印——这会 panic,因为 msg*string,得解引用:*msg

  • 正确用法:msg := flag.String("msg", "", "备忘内容"); fmt.Println(*msg)
  • 如果想避免解引用,用 flag.StringVar 配合已有变量:var msg string; flag.StringVar(&msg, "msg", "", "备忘内容")
  • flag.Stringflag.StringVar 行为一致,只是接口不同;后者更易读、少出错

如何支持「添加」和「列出」两个子命令(类似 memo add -m "xxx"

Go 标准库 flag 本身不支持子命令,硬套会导致参数解析混乱(比如 memo add -m "x" 中的 -m 被顶层 flag 忽略)。必须手动切分 os.Args,提前捕获第一个非 flag 参数作为子命令名。

关键点:在调用 flag.Parse() 前,先检查 os.Args 长度,并提取子命令;之后再初始化对应子命令的 flag 集合。

立即学习go语言免费学习笔记(深入)”;

Baklib
Baklib

在线创建产品手册、知识库、帮助文档

下载
  • 不要对整个 os.Args 调一次 flag.Parse() 就完事
  • 子命令的 flag 应该各自独立定义,例如 addCmd := flag.NewFlagSet("add", flag.ContinueOnError)
  • 注意 flag.ContinueOnError:避免子命令解析失败时直接退出程序
  • 示例片段:if len(os.Args)

flag.Parse() 之后还能再解析别的参数吗

不能。每个 flag.FlagSet 实例只能调用一次 Parse(),重复调用会 panic:flag provided but not defined: -xxx。这是设计使然——Parse() 会消费掉所有匹配的参数,并把剩余非 flag 参数存进 FlagSet.Args()

如果你需要多次解析(比如主命令 + 子命令),必须用多个独立的 flag.FlagSet 实例,各自调用一次 Parse()

  • 顶层 flag 用默认 flag.CommandLine,子命令用 flag.NewFlagSet
  • 别试图复用同一个 FlagSet 解析多段参数
  • 如果忘了清空或重置,后续 Parse 会报错,错误信息里出现的 -xxx 就是上次没被识别的残留参数

备忘录数据存哪?用 JSON 文件时要注意什么

命令行工具默认没状态,每次运行都是新进程,所以必须持久化到文件。用 JSON 是合理选择,但 Go 的 json.Marshal 默认导出首字母大写的字段,小写字段会被忽略——这意味着结构体字段必须大写且加 json: tag,否则写进去的是空对象。

另一个坑是并发:如果用户快速连发两条 memo add,可能两个进程同时读-改-写同一文件,导致丢失数据。简单 CLI 工具可暂不处理并发,但至少要加 os.O_APPEND 或全量重写时用临时文件 + os.Rename 避免中间态损坏。

  • 结构体字段必须导出:type Note struct { Text string `json:"text"`; Time string `json:"time"` }
  • 写文件前先 ioutil.WriteFile 到临时路径,再 os.Rename 替换原文件,保证原子性
  • 读文件时检查 os.IsNotExist(err),首次运行要容忍空文件或不存在
  • 别用 flag.String 接收文件路径然后直接 os.Open——用户可能输错路径,记得加错误处理
事情说清了就结束

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

207

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

242

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

350

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

212

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

405

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

385

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

200

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

1131

2025.06.17

batoto漫画官网入口与网页版访问指南
batoto漫画官网入口与网页版访问指南

本专题系统整理batoto漫画官方网站最新可用入口,涵盖最新官网地址、网页版登录页面及防走失访问方式说明,帮助用户快速找到batoto漫画官方平台,稳定在线阅读各类漫画内容。

327

2026.02.25

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go 教程
Go 教程

共32课时 | 5.6万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号