# 使用 Homebrew 安装 goenv

查看 goenv 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:goenv
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install goenv
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:goenv
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/goenv>
- **版本:** 3.1.4
- **来源摘要:** Go version management
- **主页:** <https://github.com/go-nv/goenv>
- **仓库:** <https://github.com/go-nv/goenv>
- **上游文档:** <https://github.com/go-nv/goenv#readme>
- **许可证:** MIT
- **源码归档:** <https://github.com/go-nv/goenv/archive/refs/tags/3.1.4.tar.gz>
- **最后更新:** 2026-06-09T23:47:04Z
- **已生成:** 2026-07-25T07:20:51+00:00

## 可执行文件

- goenv (cli)
- goenv (别名)

## 构建依赖

- go

## 安装行为

- post-install 钩子: 未定义
- 注意事项: If you are upgrading from goenv v2, you may need to remove the stale shim: rm -f "${GOENV_ROOT:-$HOME/.goenv}/shims/goenv"
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-25
- 管理器版本: 3.1.4
- 管理器更新时间: 2026-06-09
- 本地数据: OK
- 上游仓库: https://github.com/go-nv/goenv
- 检测到的最新版本: 3.1.4 (当前)
## 项目历史与用法

goenv is a Go version manager modeled after pyenv and rbenv. It uses shims, global and per-project version files, and a go-build plugin to let developers install and switch Go toolchains without replacing the system Go.

### 项目历史

The public repository was created in April 2016. The README says goenv aims to follow the successful version-management model of pyenv and rbenv, and that it was cloned from pyenv and modified for Go.

The project began as a shell-oriented version manager with pyenv-style commands and later introduced a v3 line described by the README as a complete rewrite from shell scripts to a Go-based CLI while preserving backward compatibility with v2.

### 采用历史

goenv's adoption follows the dotfile and language-version-manager path: developers install it into `~/.goenv`, initialize it in a shell, then use `.go-version` files to pin projects. Homebrew packages it as formula `goenv`, with `goenv@3` as an alias in formula metadata.

Repository metadata showed more than two thousand stars by June 2026. The batch package metadata lists Homebrew packaging, which is the main package-manager path in this input set.

### 使用方式

Typical setup clones or installs goenv, adds `eval "$(goenv init -)"` to the shell, installs a Go version with `goenv install`, and selects it with `goenv global`, `goenv local`, or `GOENV_VERSION`.

The command reference documents pyenv-style subcommands such as `goenv versions`, `which`, `whence`, `rehash`, `prefix`, `version-origin`, and `version-file`. Local project selection writes `.go-version`, while legacy `.goenv-version` is still read for compatibility.

### 为什么软件包爱好者会关心

Package nerds care about goenv because it is one of the cleanest examples of a language tool borrowing another ecosystem's version-manager design. The package identity is less about Go code and more about shims, version files, shell integration, plugin layout, and reproducible developer environments.

It also illustrates the maintenance tradeoff of packaging version managers: the tool has to track upstream Go releases, work across shells, preserve old version-file behavior, and avoid fighting system package managers.

### 时间线

- 2016-04: GitHub repository created.
- 2016-04: v20160417 tag published.
- 2022: v2 beta changelog entries added support for newer Go releases and `.go-version` behavior.
- 2026-04: 3.0.0 released as the Go-based CLI line.
- 2026-06: 3.1.4 released.

### Related projects

- pyenv and rbenv are the explicit design models named by goenv.
- go-build is the plugin used to install Go versions.
- gvm and crsmithdev/goenv are named in the README as alternative Go version-management approaches.

### 来源

- <https://api.github.com/repos/go-nv/goenv>
- <https://api.github.com/repos/go-nv/goenv/releases>
- <https://formulae.brew.sh/api/formula/goenv.json>
- <https://github.com/go-nv/goenv>
- <https://github.com/go-nv/goenv/blob/master/COMMANDS.md>
- <https://github.com/go-nv/goenv/blob/master/INSTALL.md>
- <https://github.com/go-nv/goenv/releases>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: $GOENV_ROOT/version, ~/.goenv/version, .go-version, .goenv-version
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** goenv
- **Aliases:** goenv@3
- **Version Scheme:** 1
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## 相关链接

- [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/zh-hans/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/zh-hans/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://www.automicvault.com/zh-hans/pkg/brew/go/) - Build dependency declared by Homebrew.
- [goenv@2](https://www.automicvault.com/zh-hans/pkg/brew/goenv-2/) - Package name indicates the same formula family.
- [nodebrew](https://www.automicvault.com/zh-hans/pkg/brew/nodebrew/) - Shares av.db curated category or tags: cli, developer-tools, development-environment, version-manager.
- [nodenv](https://www.automicvault.com/zh-hans/pkg/brew/nodenv/) - Shares av.db curated category or tags: cli, developer-tools, development-environment, version-manager.
- [phpbrew](https://www.automicvault.com/zh-hans/pkg/brew/phpbrew/) - Shares av.db curated category or tags: cli, developer-tools, development-environment, version-manager.
- [rbenv](https://www.automicvault.com/zh-hans/pkg/brew/rbenv/) - Shares av.db curated category or tags: cli, developer-tools, development-environment, version-manager.
- [addlicense](https://www.automicvault.com/zh-hans/pkg/brew/addlicense/) - Shares av.db curated category or tags: cli, developer-tools, go.
- [ali](https://www.automicvault.com/zh-hans/pkg/brew/ali/) - Shares av.db curated category or tags: cli, developer-tools, go.
- [anycable-go](https://www.automicvault.com/zh-hans/pkg/brew/anycable-go/) - Shares av.db curated category or tags: cli, developer-tools, go.

## Combined YAML source

View the package source record on GitHub. [combined/goenv.yml](https://github.com/automic-vault/db/blob/main/combined/goenv.yml)


## 来源

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
