答案：使用Golang开发命令行词典工具需先定义功能，通过Free Dictionary API获取单词释义，用net/http发起请求，encoding/json解析响应，定义结构体映射JSON数据，格式化输出结果，并编译安装至系统路径供全局调用。
想用 Golang 写一个命令行词典工具？这不仅是个练手的好项目，还能帮你熟悉网络请求、命令行参数处理和 JSON 解析等核心技能。下面是一个清晰、实用的开发步骤，带你从零实现一个简单的 CLI 词典工具。
1. 明确功能需求
先定义你的词典工具要做什么：
- 输入一个单词，返回它的中文释义
- 支持基本发音或例句（可选）
- 通过 HTTP 调用第三方翻译 API（如：有道、金山词霸或 Free Dictionary API）
- 命令行直接使用：dict hello
建议初学者使用 Free Dictionary API（免费、无须 API Key）：
https://api.dictionaryapi.dev/api/v2/entries/en/
2. 初始化项目结构
创建项目目录并初始化模块：
立即学习“go语言免费学习笔记（深入）”；
mkdir dict-cli
cd dict-cli
go mod init dict-cli
项目结构很简单：
. ├── main.go └── go.mod
3. 编写主程序逻辑
① 解析命令行参数
获取用户输入的单词：
package main
import (
"fmt"
"os"
)
func main() {
if len(os.Args) < 2 {
fmt.Println("Usage: dict ")
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：
go build -o dict main.go
将二进制文件移到系统路径：
sudo mv dict /usr/local/bin/
之后就可以全局使用：
dict hello
输出示例：
? hello【interjection】
- used as a greeting or to begin a phone conversation
【noun】
- an utterance of “hello”; a greeting
5. 可选优化项
- 缓存机制：用 BoltDB 或文件缓存查过的单词，避免重复请求
-
彩色输出：引入
fatih/color让结果更醒目 - 历史记录：记录最近查询的单词
- 模糊查询提示：当拼错时给出建议
- 离线词库：嵌入 SQLite 词典数据库（如 StarDict）
基本上就这些。不复杂但容易忽略细节，比如错误处理和用户体验。只要一步步来，你很快就能拥有一个自己写的实用小工具。
