# gvm

**Repository Path**: ZaneGitHome/gvm

## Basic Information

- **Project Name**: gvm
- **Description**: gvm是一个Linux、macOS、Windows下的命令行工具，可以提供一个便捷的多版本go环境的管理和切换
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://github.com/voidint/g
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 16
- **Created**: 2025-10-31
- **Last Updated**: 2025-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gvm

`gvm`是一个Linux、macOS、Windows下的命令行工具，可以提供一个便捷的多版本[go](https://golang.org/)环境的管理和切换。


## 特性
- 支持列出可供安装的go版本号
- 支持列出已安装的go版本号
- 支持在本地安装多个go版本
- 支持卸载已安装的go版本
- 支持在已安装的go版本之间自由切换

## 安装
### 手动安装
- 下载对应平台的[二进制压缩包](https://gitee.com/voidint/gvm/releases)。
- 将压缩包解压至`PATH`环境变量目录下，如`/usr/local/bin`。
- 编辑shell环境配置文件（`~/.bashrc`、`~/.zshrc`...）

    ```shell
    $ cat>>~/.bashrc<<EOF
    export GOROOT="${HOME}/.g/go"
    export PATH="${HOME}/.g/go/bin:$PATH"
    export G_MIRROR=https://golang.google.cn/dl/
    EOF
    ```

## 使用
查询当前可供安装的`stable`状态的go版本

```shell
$ gvm ls-remote stable
1.11.9
1.12.4
```

安装目标go版本`1.12.4`

```shell
$ gvm install 1.12.4
Installed successfully
$ go version
go version go1.12.4 darwin/amd64
```


查询已安装的go版本

```shell
$ gvm ls
1.12.4
```

查询可供安装的所有go版本

```shell
$ gvm ls-remote
1
1.2.2
1.3
1.3.1
...    // 省略若干版本
1.11.7
1.11.8
1.11.9
1.12
1.12.1
1.12.2
1.12.3
1.12.4
```

安装目标go版本`1.11.9`

```shell
$ gvm install 1.11.9
Installed successfully
$ go version
go version go1.11.9 darwin/amd64
```

切换到另一个已安装的go版本

```shell
$ gvm ls
1.11.9
1.12.4
$ gvm use 1.12.4
go version go1.12.4 darwin/amd64

```

卸载一个已安装的go版本

```shell
gvm uninstall 1.11.9
Uninstall successfully
```
## FAQ
- `gvm`与[g](https://github.com/voidint/g)有什么区别？

    同一个项目。只不过因为gitee要求仓库名字符数必须>=2，因此将项目重命名为`gvm`。

- 环境变量`G_MIRROR`有什么作用？

    由于中国大陆无法自由访问Golang官网，导致查询及下载go版本都变得困难，因此可以通过该环境变量指定一个镜像站点（如`https://golang.google.cn/dl/`），g将从该站点查询、下载可用的go版本。

- 支持源代码编译安装吗？

    不支持


## 鸣谢
感谢[nvm](https://github.com/nvm-sh/nvm)、[n](https://github.com/tj/n)、[rvm](https://github.com/rvm/rvm)等工具提供的宝贵思路。