![dvm](https://socialify.git.ci/justjavac/dvm/image?description=1&font=Bitter&forks=1&issues=1&language=1&logo=https%3A%2F%2Fdeno.land%2Fimages%2Fartwork%2Fogdeno.png&name=1&owner=1&pattern=Circuit%20Board&pulls=1&stargazers=1&theme=Light)

[English](https://github.com/qiuquanwu/dvm/) | 简体中文

## 安装

您可以使用下面的安装程序安装它，或者从[发布页](https://github.com/justjavac/dvm/releases)面下载源文件。

**Shell 安装：**

```sh
curl -fsSL https://deno.land/x/dvm/install.sh | sh
```

**PowerShell 安装：**

```powershell
irm https://deno.land/x/dvm/install.ps1 | iex
```

**设置中文镜像：`dvm registry cn`**。

## 使用

```console
➜  ~  dvm --help
Deno Version Manager - Easy way to manage multiple active deno versions.

Usage: dvm.exe <COMMAND>

Commands:
  completions  Generate shell completions
  info         Show dvm info.
  install      Install deno executable to the given version. [aliases: i, add]
  list         List all installed versions [aliases: ls, ll, la]
  list-remote  List all released versions [aliases: lr, ls-remote]
  uninstall    Uninstall a given version [aliases: un, unlink, rm, remove]
  use          Use a given version or a semver range or a alias to the range.
  alias        Set or unset an alias
  activate     Activate Dvm
  deactivate   Deactivate Dvm
  doctor       Fixing dvm specific environment variables and other issues
  upgrade      Upgrade aliases to the latest version, use `self` to upgrade dvm itself
  exec         Execute deno command with a specific deno version
  clean        Clean dvm cache
  registry     Change registry that dvm fetch from
  update       Update remove version list local cache to the latest
  help         Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help information
  -V, --version  Print version information

EXAMPLE:
  dvm install 1.3.2     Install v1.3.2 release
  dvm install           Install the latest available version
  dvm use 1.0.0         Use v1.0.0 release
  dvm use latest        Use the latest alias that comes with dvm, equivalent to *
  dvm use canary        Use the canary version of the Deno

NOTE:
  To remove, delete, or uninstall dvm - just remove the `$DVM_DIR` folder (usually `~/.dvm`)
```

### 验证

要验证 dvm 是否已安装，输入：

```bash
dvm -V
```

如果输出 dvm 的版本，则已经安装成功。

### 初始化

使用 `dvm` 将创建 `~/.dvm/` 文件夹，并且所有已安装的 deno 版本都将放入中
`~/.dvm`文件夹之中。

```
➜  ~  dvm
Creating /Users/justjavac/.dvm
```

### .dvmrc

你可以让 dvm
在当前目录生成配置文件，之后`dvm use`和`dvm install`如果没指定版本号就会优先采用当前目录下的配置文件

举个栗子：我们先设置 1.17.0 为默认版本

```bash
dvm use --local 1.17.0
```

然后假设另一个人拿到了你这个项目并且根目录里有你生成的 dvm
配置文件，并运行`dvm use`

```plain
$ dvm use
No version input detect, try to use version in .dvmrc file
Using semver range: 1.17.0
Writing to home folder config
Now using deno 1.17.0
```

## 举个例子

### 查看版本

列出所有安装的版本：

```
➜  ~  dvm list
 * 0.1.0
   0.1.1
   0.1.2
```

带（\*）的版本表示此版本是当前使用的版本。

### 切换版本

```
➜  ~  dvm use 1.1.0
now use deno 1.1.0
➜  ~  dvm use 1.2.0
deno v1.2.0 is not installed. Use `dvm install 1.2.0` to install it first.
```

## 兼容性

- Shell 安装程序可以在带有
  [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/about)，
  [MSYS](https://www.msys2.org) 或等效工具集的 Windows 上使用。

## 常见问题

### unzip is required

此项目需要依赖 [`unzip`](https://linux.die.net/man/1/unzip) 进行 Shell 安装。

```sh
$ curl -fsSL https://deno.land/x/dvm/install.sh | sh
Error: unzip is required to install dvm (see: https://github.com/justjavac/dvm#unzip-is-required).
```

**此问题何时出现？**

在运行 `install.sh` 过程中，会使用 `unzip` 提取 zip 文件。

**如何解决？**

- MacOs 使用 `brew install unzip` 安装 unzip。
- Ubuntu，Debian 使用`apt-get install unzip -y` 安装 unzip。
- CentOS 使用 `yum install -y unzip zip` 安装 unzip。

### Windows 平台 需要使用 Powershell 来运行 dvm

目前我们因为一些原因使用的是 Powershell profile 来设置环境变量, 所以 Powershell
是必需的.

## 开源协议

Deno 版本管理器 （dvm） 遵循 MIT 开源协议。有关详细信息，请参阅
[LICENSE](./LICENSE)。