如何用 Golang 写一个命令行词典工具_Golang CLI 词典项目开发步骤-Golang-PHP中文网

如何用 Golang 写一个命令行词典工具_Golang CLI 词典项目开发步骤

P粉602998670

发布： 2025-11-25 20:13:02

原创

594人浏览过

答案：使用Golang开发命令行词典工具需先定义功能，通过Free Dictionary API获取单词释义，用net/http发起请求，encoding/json解析响应，定义结构体映射JSON数据，格式化输出结果，并编译安装至系统路径供全局调用。

如何用 golang 写一个命令行词典工具_golang cli 词典项目开发步骤

想用 Golang 写一个命令行词典工具？这不仅是个练手的好项目，还能帮你熟悉网络请求、命令行参数处理和 JSON 解析等核心技能。下面是一个清晰、实用的开发步骤，带你从零实现一个简单的 CLI 词典工具。

1. 明确功能需求

先定义你的词典工具要做什么：

输入一个单词，返回它的中文释义
支持基本发音或例句（可选）
通过 HTTP 调用第三方翻译 API（如：有道、金山词霸或 Free Dictionary API）
命令行直接使用：dict hello

建议初学者使用 Free Dictionary API（免费、无须 API Key）：

https://api.dictionaryapi.dev/api/v2/entries/en/<word>

登录后复制

2. 初始化项目结构

创建项目目录并初始化模块：

立即学习“go语言免费学习笔记（深入）”；

mkdir dict-cli<br>cd dict-cli<br>go mod init dict-cli

登录后复制

项目结构很简单：

.
├── main.go
└── go.mod

登录后复制

3. 编写主程序逻辑

在 main.go 中实现以下步骤：

① 解析命令行参数
获取用户输入的单词：

package main

import (
    "fmt"
    "os"
)

func main() {
    if len(os.Args) < 2 {
        fmt.Println("Usage: dict <word>")
        os.Exit(1)
    }
    word := os.Args[1]
    lookup(word)
}

登录后复制

② 定义数据结构
根据 API 返回的 JSON 结构定义 Go 的 struct：

type Definition struct {
    Definition string `json:"definition"`
    Example    string `json:"example,omitempty"`
}

type Meaning struct {
    PartOfSpeech string       `json:"partOfSpeech"`
    Definitions  []Definition `json:"definitions"`
}

type DictionaryResponse []struct {
    Word    string   `json:"word"`
    Meanings []Meaning `json:"meanings"`
}

登录后复制

③ 发起 HTTP 请求并解析结果
使用 net/http 和 encoding/json：

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func lookup(word string) {
    url := fmt.Sprintf("https://api.dictionaryapi.dev/api/v2/entries/en/%s", word)
    resp, err := http.Get(url)
    if err != nil {
        fmt.Printf("Request failed: %v\n", err)
        return
    }
    defer resp.Body.Close()

    if resp.StatusCode == 404 {
        fmt.Printf("Word '%s' not found.\n", word)
        return
    }

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        fmt.Printf("Read body failed: %v\n", err)
        return
    }

    var data DictionaryResponse
    if err := json.Unmarshal(body, &data); err != nil {
        fmt.Printf("Parse JSON failed: %v\n", err)
        return
    }

    printResult(data[0])
}

登录后复制

④ 格式化输出结果
让结果显示更清晰：

func printResult(entry struct {
    Word     string
    Meanings []Meaning
}) {
    fmt.Printf("\n? %s\n\n", entry.Word)

    for _, m := range entry.Meanings {
        fmt.Printf("【%s】\n", m.PartOfSpeech)
        for i, d := range m.Definitions {
            fmt.Printf("  %d. %s", i+1, d.Definition)
            if d.Example != "" {
                fmt.Printf(" (e.g. %s)", d.Example)
            }
            fmt.Println()
        }
        fmt.Println()
    }
}

登录后复制

4. 构建并安装命令行工具

编译成可执行文件，并加入 PATH：

灵云AI开放平台

150

查看详情

go build -o dict main.go

登录后复制

将二进制文件移到系统路径：

sudo mv dict /usr/local/bin/

登录后复制

之后就可以全局使用：

dict hello

登录后复制

输出示例：

? hello
<p>【interjection】</p><ol><li>used as a greeting or to begin a phone conversation</li></ol><p>【noun】</p><ol><li>an utterance of “hello”; a greeting

登录后复制