当前位置:

首页 > 系统应用 > 一个小时学会用Go编写命令行工具

一个小时学会用Go编写命令行工具

前言最近因为项目需要写了一段时间的 Go ,相对于 Java 来说语法简单同时又有着一些 Python 之类的语法糖,让人大呼”真香“。但现阶段相对来说还是 Python 写的多一些,偶尔还得回炉写点 Java ;自然对 Go 也谈不上多熟悉。于是便利用周末时间自己做个小项目来加深一些使用经验。于是

本文目录
    前言

    最近因为项目需要写了一段时间的 Go ,相对于 Java 来说语法简单同时又有着一些 Python 之类的语法糖,让人大呼”真香“。

    但现阶段相对来说还是 Python 写的多一些,偶尔还得回炉写点 Java ;自然对 Go 也谈不上多熟悉。

    于是便利用周末时间自己做个小项目来加深一些使用经验。于是我便想到了之前利用 Java 写的一个博客小工具。

    那段时间正值微博图床大量图片禁止外链,导致许多个人博客中的图片都不能查看。这个工具可以将文章中的图片备份到本地,还能将图片直接替换到其他图床。

    本人目前一直在用,通常在码字时借助 iPic 这类工具将图片上传至微博图床(主要是图方便且免费)。写完后再通过该工具一键切换到 [SM.MS](http://sm.MS) 这类付费图床,同时也会将图片备份到本地磁盘。

    改为用 Go 重写为 cli 工具后使用效果如下:

    需要掌握哪些技能

    之所以选择这个工具用 Go 来重写;一个是功能比较简单,但也正好可以利用到 Go 的一些特点,比如网络 IO、协程同步之类。

    同时修改为命令行工具后是不是感觉更极客了呢。

    再开始之前还是先为不熟悉 Go 的 Javaer 介绍下大概会用到哪些知识点:

    • 使用和管理第三方依赖包(go mod)
    • 协程的运用。
    • 多平台打包。

    下面开始具体操作,我觉得即便是没怎么接触过 Go 的朋友看完之后也能快速上手实现一个小工具。

    使用和管理第三方依赖

    • 还没有安装 Go 的朋友请参考官网自行安装。

    首先介绍一下 Go 的依赖管理,在版本 1.11 之后官方就自带了依赖管理模块,所以在当下最新版 1.15 中已经强烈推荐使用。

    它的目的和作用与 Java 中的 maven,Python 中的 pip 类似,但使用起来比 maven 简单许多。

    依据其使用指南,需先在项目目录下执行 go mod init 命令来初始化一个 go.mod 文件。当然,若你使用的是像 GoLang 这样的 IDE,在新建项目时,它会自动为我们创建好目录结构,其中自然也包括 go.mod 这个文件。

    在这个文件中我们引入我们需要的第三方包:

    module btb

    go 1.15

    require (
    github.com/cheggaaa/pb/v3 v3.0.5
    github.com/fatih/color v1.10.0
    github.com/urfave/cli/v2 v2.3.0
    )

    我这里使用了三个包,分别是:

    • pb: progress bar,用于在控制台输出进度条。
    • color: 用于在控制台输出不同颜色的文本。
    • cli: 命令行工具开发包。
    import (
    "btb/constants"
    "btb/service"
    "github.com/urfave/cli/v2"
    "log"
    "os"
    )

    func main() {
    var model string
    downloadPath := constants.DownloadPath
    markdownPath := constants.MarkdownPath

    app := &cli.App{
    Flags: []cli.Flag{
    &cli.StringFlag{
    Name: "model",
    Usage: "operating mode; r:replace, b:backup",
    DefaultText: "b",
    Aliases: []string{"m"},
    Required: true,
    Destination: &model,
    },
    &cli.StringFlag{
    Name: "download-path",
    Usage: "The path where the image is stored",
    Aliases: []string{"dp"},
    Destination: &downloadPath,
    Required: true,
    Value: constants.DownloadPath,
    },
    &cli.StringFlag{
    Name: "markdown-path",
    Usage: "The path where the markdown file is stored",
    Aliases: []string{"mp"},
    Destination: &markdownPath,
    Required: true,
    Value: constants.MarkdownPath,
    },
    },
    Action: func(c *cli.Context) error {
    service.DownLoadPic(markdownPath, downloadPath)

    return nil
    },
    Name: "btb",
    Usage: "Help you backup and replace your blog's images",
    }

    err := app.Run(os.Args)
    if err != nil {
    log.Fatal(err)
    }
    }

    代码非常简单,无非就是使用了 cli 所提供的 api 创建了几个命令,将用户输入的 -dp、-mp 参数映射到 downloadPath、markdownPath 变量中。

    之后便利用这两个数据扫描所有的图片,以及将图片下载到对应的目录中。

    更多使用指南可以直接参考官方文档。

    可以看到部分语法与 Java 完全不同,比如:

    • 申明变量时类型是放在后边,先定义变量名称;方法参数类似。
    • 类型推导,可以不指定变量类型(新版本的 Java 也支持)
    • 方法支持同时返回多个值,这点非常好用。
    • 公共、私用函数利用首字母大小写来区分。
    • 还有其他的就不一一列举了。

    协程

    紧接着命令执行处调用了 service.DownLoadPic(markdownPath, downloadPath) 处理业务逻辑。

    这里包含的文件扫描、图片下载之类的代码就不分析了;官方 SDK 写的很清楚,也比较简单。

    重点看看 Go 里的 goroutime 也就是协程。

    我这里使用的场景是每扫描到一个文件就利用一个协程去解析和下载图片,从而可以提高整体的运行效率。

    func DownLoadPic(markdownPath, downloadPath string) {
    wg := sync.WaitGroup{}
    allFile, err := util.GetAllFile(markdownPath)
    wg.Add(len(*allFile))

    if err != nil {
    log.Fatal("read file error")
    }

    for _, filePath := range *allFile {

    go func(filePath string) {
    allLine, err := util.ReadFileLine(filePath)
    if err != nil {
    log.Fatal(err)
    }
    availableImgs := util.MatchAvailableImg(allLine)
    bar := pb.ProgressBarTemplate(constants.PbTmpl).Start(len(*availableImgs))
    bar.Set("fileName", filePath).
    SetWidth(120)

    for _, url := range *availableImgs {
    if err != nil {
    log.Fatal(err)
    }
    err := util.DownloadFile(url, *genFullFileName(downloadPath, filePath, &url))
    if err != nil {
    log.Fatal(err)
    }
    bar.Increment()

    }
    bar.Finish()
    wg.Done()

    }(filePath)
    }
    wg.Wait()
    color.Green("Successful handling of [%v] files.n", len(*allFile))

    if err != nil {
    log.Fatal(err)
    }
    }

    就代码使用层面看起来是不是要比 Java 简洁许多,我们不用像 Java 那样需要维护一个 executorService,也不需要考虑这个线程池的大小,一切都交给 Go 自己去调度。

    使用时只需要在调用函数之前加上 go 关键字,只不过这里是一个匿名函数。

    而且由于 goroutime 非常轻量,与 Java 中的 thread 相比占用非常少的内存,所以我们也不需要精准的控制创建数量。

    不过这里也用到了一个和 Java 非常类似的东西:WaitGroup。

    它的用法与作用都与 Java 中的 CountDownLatch 非常相似;主要用于等待所有的 goroutime 执行完毕,在这里自然是等待所有的图片都下载完毕然后退出程序。

    使用起来主要分为三步:

    • 创建和初始化 goruntime 的数量:wg.Add(len(number)
    • 每当一个 goruntime 执行完毕调用 wg.Done() 让计数减一。
    • 最终调用 wg.Wait() 等待WaitGroup 的数量减为0。

    对于协程 Go 推荐使用 chanel 来互相通信,这点今后有机会再讨论。

    打包

    核心逻辑也就这么多,下面来讲讲打包与运行;这点和 Java 的区别就比较大了。

    众所周知,Java 有一句名言:write once run anywhere

    这是因为有了 JVM 虚拟机,所以我们不管代码最终运行于哪个平台都只需要打出一个包;但 Go 没有虚拟机它是怎么做到在个各平台运行呢。

    简单来说 Go 可以针对不同平台打包出不同的二进制文件,这个文件包含了所有运行所需要的依赖,甚至都不需要在目标平台安装 Go 环境。

    • 虽说 Java 最终只需要打一个包,但也得在各个平台安装兼容的 Java 运行环境。

    我在这里编写了一个 Makefile 用于执行打包:make release

    # Binary name
    BINARY=btb
    GOBUILD=go build -ldflags "-s -w" -o ${BINARY}
    GOCLEAN=go clean
    RMTARGZ=rm -rf *.gz
    VERSION=0.0.1

    release:
    # Clean
    $(GOCLEAN)
    $(RMTARGZ)
    # Build for mac
    CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 $(GOBUILD)
    tar czvf ${BINARY}-mac64-${VERSION}.tar.gz ./${BINARY}
    # Build for arm
    $(GOCLEAN)
    CGO_ENABLED=0 GOOS=linux GOARCH=arm64 $(GOBUILD)
    tar czvf ${BINARY}-arm64-${VERSION}.tar.gz ./${BINARY}
    # Build for linux
    $(GOCLEAN)
    CGO_ENABLED=0 GOOS=linux GOARCH=amd64 $(GOBUILD)
    tar czvf ${BINARY}-linux64-${VERSION}.tar.gz ./${BINARY}
    # Build for win
    $(GOCLEAN)
    CGO_ENABLED=0 GOOS=windows GOARCH=amd64 $(GOBUILD).exe
    tar czvf ${BINARY}-win64-${VERSION}.tar.gz ./${BINARY}.exe
    $(GOCLEAN)

    可以看到我们只需要在 go build 之前指定系统变量即可打出不同平台的包,比如我们为 Linux 系统的 arm64 架构打包文件:

    CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build main.go -o btb

    便可以直接在目标平台执行 ./btb 运行程序。

    总结

    本文所有代码都已上传 Github: https://github.com/crossoverJie/btb

    感兴趣的也可以直接运行安装脚本体验。

    curl -fsSL https://raw.githubusercontent.com/crossoverJie/btb/master/install.sh | bash
    • 目前这个版本只实现了图片下载备份,后续会完善图床替换及其他功能。

    这段时间接触 Go 之后给我的感触颇深,对于年纪 25 岁的 Java 来说,Go 确实是后生可畏,更气人的是还赶上了云原生这个浪潮,就更惹不起了。

    一些以前看来不那么重要的小毛病也被重点放大,比如启动慢、占用内存多、语法啰嗦等;不过我依然对这位赏饭吃的祖师爷保持期待,从新版本的 Java 可以看出也在积极改变,更不用说它还有无人撼动的庞大生态。

    更多 Java 后续内容可以参考周志明老师的文章:云原生时代,Java危矣?

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    系统应用 命令行工具
    相关文章 更多
    claude code install mac Mac版安装教程
    claude code install mac Mac版安装教程

    针对macOS用户,提供Claude Code的完整安装与配置流程。涵盖Homebrew安装、API密钥设置及VS Code集成,解决终端权限与环境变量问题,助力开发者高效启用AI编程辅助。

    VSCode运行Dart命令行工具:配置Dart SDK环境变量底层逻辑
    VSCode运行Dart命令行工具:配置Dart SDK环境变量底层逻辑

    配置DartSDK环境变量需将dart-sdk/bin加入系统PATH,修改后需重启VSCode或重新加载窗口使新变量生效。调试纯Dart项目时,用OpenFolder打开项目根目录,并确保program指向bin/main.dart。dart.sdkPath通常留空使用系统默认SDK,仅当需要多版本或自定义SDK路径时才手动指定根目录,注意路径要正确。

    JDK自带的四大命令行工具(jstat/jstack/jmap/jhat)的使用详解
    JDK自带的四大命令行工具(jstat/jstack/jmap/jhat)的使用详解

    JDK自带的jstat、jstack、jmap、jhat四大命令行工具,无需额外安装即可用于定位Java应用性能瓶颈、内存泄漏、死锁及CPU飙高等问题。jstat监控GC和内存,jstack排查线程死锁,jmap导出堆快照,jhat分析堆内存,覆盖常见线上问题排查场景。

    阿里云Meoo推出开源命令行工具Meoo CLI 本地AI编程项目可直接部署上线
    阿里云Meoo推出开源命令行工具Meoo CLI 本地AI编程项目可直接部署上线

    阿里云Meoo发布开源命令行工具MeooCLI,作为连接本地AI编程助手与云端部署的桥梁。通过自然语言指令,可自动完成数据库开通、接口生成、用户登录及项目发布,无需手动登录云控制台,几秒内即可获得可分享的线上链接。

    Python-GDAL离线文档下载指南
    Python-GDAL离线文档下载指南

    一个有趣的灵魂WGdal的官网一搜就有了:www.gdal.org。里面对gdal各种函数的描绘,一应俱全,有时候即使不用python的gdal包。通过安装gdal后,也能使用subprocess调用cmd,使用gdal的各种功能和函数。但问题和弊端总是接踵而至,之前分享过一篇文章,里面就有windows系统cmd的不足,windows下cmd的命令输入长度受限:windows的cmd是有输入字符长度限制的,据查,win7以上的系统大概是8k个字符长度(数字、英文),所以,一旦输入的字符长度过长,就需要分

    PHP一键环境CLI模式使用教程
    PHP一键环境CLI模式使用教程

    答案:本文介绍如何在CLI模式下使用XAMPP、WAMP等PHP一键环境进行开发调试。首先验证php-v确认PHP是否加入系统路径,若未添加需手动配置;接着可通过phptest.php直接运行PHP脚本,适用于定时任务与API调试;部分环境支持命令行启停服务,如XAMPP在Linux/macOS中使用sudo/opt/lampp/lamppstart/stop;还可利用php-Slocalhost:8000启动内置服务器预览项目,Laravel等框架可指定-tpublic/作为根目录;掌握CLI操作可提升

    Windows命令行实用技巧大全
    Windows命令行实用技巧大全

    初次接触Stata的用户可能对命令行操作不太熟悉,但可以通过学习常用的Windows命令行命令来逐步适应。掌握这些命令不仅能熟悉命令操作,还能体验到命令行操作的便捷性,从而提升工作效率。如果你对Windows命令行的起源和终端演变感兴趣,可以参考微软官网的介绍:WindowsCommand-Line:Backgrounder[1]。要在Windows中操作控制台命令窗口,可以使用win+R快捷键打开运行对话框,然后输入cmd来启动控制台命令窗口。另外,可以使用cmd/c和

    Golang解析复杂flag参数教程
    Golang解析复杂flag参数教程

    要使用结构体和flag包优雅地管理多个flag,首先定义结构体将flag参数映射为字段,接着通过flag.StringVar、flag.IntVar等函数绑定结构体字段指针,最后调用flag.Parse解析并在主函数中访问配置。针对列表或字典类型的flag参数,需自定义类型实现flag.Value接口的Set和String方法,再通过flag.Var绑定该类型变量以支持复杂数据结构。若需更细粒度控制,可手动解析os.Args,自行处理参数匹配、值提取及错误处理,从而实现高度定制化的参数解析逻辑。

    Golang编写首个命令行工具:flag与os.Args详解
    Golang编写首个命令行工具:flag与os.Args详解

    学习Golang命令行参数处理,首选os.Args和flag包。1.os.Args适合获取简单、少量的参数,直接以字符串切片形式提供所有输入参数;2.flag包适合需要结构化解析的场景,支持类型化参数定义及标准格式(如-name=value),并可获取未被解析的位置参数。选择依据:参数少且无需复杂解析时用os.Args,参数多或需规范格式与默认值时用flag包。

    Win10 CMD命令与实用快捷键大全
    Win10 CMD命令与实用快捷键大全

    大家好,很高兴再次和大家见面,我是你们的老朋友全栈君。一、WindowsCMD命令全集1、通过按下Win(Windows图标键)+R键,调出运行窗口,输入“cmd”后按回车键,即可启动CMD命令提示符。2、在命令提示符窗口中右击并选择“属性”,即可进行个性化设置。以下是常用命令及其功能的列表:命令功能calc启动计算器appwiz.cpl打开程序和功能界面certmgr.msc启动证书管理实用程序charmap打开字符映射表chkdsk.exe执行磁盘检查(需要以管理员身份运行)cleanm

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。