Golang 独立二进制文件包管理工具 - Stew 使用指南

Stew 是一个用于管理独立二进制文件的 Go 语言工具，类似于 Homebrew 或 Scoop，但专注于管理独立的二进制应用程序。它可以帮助你轻松安装、更新和管理各种 CLI 工具。

安装 Stew

首先安装 Stew 本身：

# 使用官方安装脚本
curl -fsSL https://raw.githubusercontent.com/marwanhawari/stew/master/install.sh | sh

# 或者通过 Go 安装
go install github.com/marwanhawari/stw@latest

安装完成后，Stew 的二进制文件会默认安装在 ~/.stew/bin 目录下，你需要将这个目录添加到 PATH 环境变量中：

# 对于 bash/zsh
echo 'export PATH="$HOME/.stew/bin:$PATH"' >> ~/.bashrc  # 或 ~/.zshrc
source ~/.bashrc

# 对于 fish
echo 'set -gx PATH $HOME/.stew/bin $PATH' >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish

基本使用

1. 搜索包

stew search ripgrep

2. 安装包

stew install ripgrep

3. 列出已安装的包

stew list

4. 更新包

stew upgrade ripgrep

5. 更新所有包

stew upgrade-all

6. 卸载包

stew uninstall ripgrep

高级功能

从特定来源安装

Stew 支持从 GitHub 发布、直接 URL 或自定义来源安装：

# 从 GitHub 发布安装
stew install gh:cli/cli

# 从直接 URL 安装
stew install https://example.com/tool.tar.gz

创建自定义包定义

你可以在 ~/.stew/packages 目录下创建自定义包定义。例如创建一个 my-tool.json：

{
  "name": "my-tool",
  "version": "1.0.0",
  "description": "My custom tool",
  "homepage": "https://example.com",
  "binaries": [
    {
      "url": "https://example.com/releases/my-tool-{{.OS}}-{{.Arch}}.tar.gz",
      "files": [
        {
          "path": "my-tool",
          "name": "my-tool"
        }
      ]
    }
  ]
}

然后就可以像普通包一样安装：

stew install my-tool

使用 Go 代码与 Stew 交互

以下是一个简单的 Go 程序，演示如何通过代码与 Stew 交互：

package main

import (
	"fmt"
	"os/exec"
)

func main() {
	// 搜索包
	searchResult, err := exec.Command("stew", "search", "ripgrep").Output()
	if err != nil {
		fmt.Printf("搜索失败: %v\n", err)
		return
	}
	fmt.Printf("搜索结果:\n%s\n", searchResult)

	// 安装包
	fmt.Println("正在安装 ripgrep...")
	installCmd := exec.Command("stew", "install", "ripgrep")
	installCmd.Stdout = os.Stdout
	installCmd.Stderr = os.Stderr
	if err := installCmd.Run(); err != nil {
		fmt.Printf("安装失败: %v\n", err)
		return
	}
	fmt.Println("安装成功!")
}

配置 Stew

Stew 的配置文件位于 ~/.stew/config.json，可以配置以下选项：

{
  "bin_path": "~/.stew/bin",
  "pkg_path": "~/.stew/packages",
  "log_path": "~/.stew/logs",
  "update_frequency": 24
}

注意事项

1. Stew 主要设计用于 Linux/macOS，Windows 支持可能有限
2. 某些包可能需要手动处理依赖关系
3. 使用前建议先 stew update 更新包索引
4. 对于生产环境，建议先测试包的兼容性

Stew 是一个轻量级的解决方案，特别适合需要管理多个独立二进制文件的开发环境。它比传统的包管理器更灵活，比手动下载更方便。