Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ghosind/dvm
Deno Version Manager (DVM) - A lightweight, and powerful Deno Version Manager for MacOS, Linux, WSL, and Windows with Bash.
https://github.com/ghosind/dvm
deno deno-version-manager dvm install version-manager
Last synced: 3 days ago
JSON representation
Deno Version Manager (DVM) - A lightweight, and powerful Deno Version Manager for MacOS, Linux, WSL, and Windows with Bash.
- Host: GitHub
- URL: https://github.com/ghosind/dvm
- Owner: ghosind
- License: mit
- Created: 2020-05-12T07:23:19.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-10-16T16:52:27.000Z (23 days ago)
- Last Synced: 2024-10-18T15:46:01.379Z (21 days ago)
- Topics: deno, deno-version-manager, dvm, install, version-manager
- Language: Shell
- Homepage: https://github.com/ghosind/dvm
- Size: 328 KB
- Stars: 38
- Watchers: 4
- Forks: 3
- Open Issues: 5
-
Metadata Files:
- Readme: README-CN.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-deno - ghosind/dvm - A lightweight Deno Version Manager for Linux/MacOS. (Tools / XML)
README
# DVM - Deno Version Manager
[](https://www.codacy.com/manual/ghosind/dvm?utm_source=github.com&utm_medium=referral&utm_content=ghosind/dvm&utm_campaign=Badge_Grade)
简体中文 | [English](./README.md)
DVM是一个强大的轻量级[Deno](https://deno.land/)版本管理工具，可在MacOS、Linux、WSL以及装有Bash的Windows上使用。
DVM仅在v0.7.0及之后的版本支持Windows。对于Windows用户，使用DVM前需要安装Bash Shell。例如，可以在安装WSL后在PowerShell中执行`bash`命令。
***在使用DVM管理你的多版本环境时，请避免使用`deno upgrade`命令进行升级deno版本。***
- [安装与升级](#安装与升级)
- [安装DVM](#安装DVM)
- [升级DVM](#升级DVM)
- [依赖需求](#依赖需求)
- [DVM入门](#DVM入门)
- [列出可安装版本](#列出可安装版本)
- [列出已安装的版本](#列出已安装的版本)
- [安装版本](#安装版本)
- [删除版本](#删除版本)
- [切换版本](#切换版本)
- [当前版本信息](#当前版本信息)
- [设置别名](#设置别名)
- [运行指定版本](#运行指定版本)
- [DVM命令](#DVM命令)
- [如何卸载DVM](#如何卸载DVM)
- [使用`purge`命令](#使用purge命令)
- [手工卸载](#手工卸载)
- [许可](#许可)
## 安装与升级
### 安装DVM
我们提供了以下两种方式以安装DVM：
1. 运行下列命令从网络安装DVM：
```sh
curl -o- https://raw.githubusercontent.com/ghosind/dvm/master/install.sh | bash
```
对于国内的用户，可使用DVM的Gitee镜像以提高下载速度：
```sh
curl -o- https://gitee.com/ghosind/dvm/raw/master/install.sh | DVM_SOURCE=gitee bash
```
2. Clone远程git仓库至本地，并运行`install.sh`脚本：
```sh
git clone "https://github.com/ghosind/dvm.git"
# 同样，可以从我们的gitee项目上clone
# git clone "https://gitee.com/ghosind/dvm.git"
cd dvm
./install.sh
```
在完成DVM的安装后，请重启终端或运行`source `以应用更改，安装程序将会提醒具体的操作步骤。
默认情况下，DVM将安装在`~/.dvm`目录下，可使用`-d `参数（仅限于本地安装使用）或`$DVM_DIR`环境变量指定一个不存在的目录作为DVM的安装目录。
```sh
curl -o- "https://raw.githubusercontent.com/ghosind/dvm/master/install.sh" | DVM_DIR=~/deno/dvm bash
./install.sh -d ~/deno/dvm
```
### 升级DVM
若您使用DVM `v0.3.0`及以上版本，可通过DVM本身提供的`upgrade`命令将本地DVM升级至最新的稳定版本。
```sh
dvm upgrade
```
若您使用DVM `v0.3.0`以下的版本时，需要卸载现有版本并重新安装的方法进行升级。您可通过[手工卸载](#手工卸载)章节提供的卸载方式卸载DVM，再重新进行安装。
## 依赖需求
请确保下列依赖软件已经安装：
- curl
- git
- unzip (Deno v0.36.0及更新的版本)
- gunzip (Deno v0.35.0及更旧的版本)
若需要从源码安装Deno，请确保以下依赖软件已经安装：
- rustc
- cargo
- cc
- cmake
## DVM入门
### 列出已安装的版本
使用`dvm ls`命令列出所有已安装的版本（及别名）：
```sh
# 列除所有当前已安装的版本
dvm ls
```
### 列出可安装版本
使用`dvm ls-remote`脚本列出所有可安装的版本：
```sh
# 列出所有可安装的版本
dvm ls-remote
```
### 安装版本
使用`dvm install `下载并安装指定版本：
```sh
dvm install v1.0.0
dvn install v0.42.0
```
### 源码安装
DVM v0.8.0及以上版本支持从源码安装Deno：
```sh
dvm install --from-source v1.35.0
```
### 删除版本
使用`dvm uninstall `卸载指定版本：
```
dvm uninstall v0.39.0
dvm uninstall v1.0.0-rc
```
### 切换版本
使用`dvm use [version]`命令将指定的版本设置为当前使用的版本，若未指定则将从当前目录下的`.dvmrc`文件中读取：
```sh
# 使用Deno v1.0.0
dvm use v1.0.0
# 使用通过.dvmrc文件指定的版本
# cat .dvmrc
# # v1.0.0
dvm use
```
通过`use`命令设置的版本仅适用于当前终端会话中，若希望为所有的终端会话设置使用的版本，请为版本设置`default`别名，可参考[设置别名](#设置别名)章节为指定版本设置别名。
### 当前版本信息
使用`dvm current`命令输出当前使用的Deno版本信息：
```sh
dvm current
# v1.0.0
```
### 设置别名
使用`dvm alias`命令可为已安装的版本设置别名：
```sh
dvm alias default v1.0.0
```
### 运行指定版本
通过`dvm run`命令运行指定版本Deno，在有参数指定的情况下通过对应的参数执行对应的脚本：
```sh
# 使用Deno v1.0.0运行app.ts
dvm run v1.0.0 app.ts
```
## DVM命令
DVM支持的命令包括有：
| 命令 | 使用方法 | 描述 |
|:-------:|:-----:|:------------|
| `install` | `dvm install` | 下载并安装从`.dvmrc`读取的指定版本或最新deno版本 |
| | `dvm install ` | 下载并安装指定的版本，或安装满足指定前缀的最新版本 |
| | `dvm install --registry=` | 通过指定的镜像下载deno |
| | `dvm install --skip-validation` | 下载deno前不对版本进行校验 |
| | `dvm install --from-source` | 编译源码并安装Deno |
| | `dvm install --skip-download-cache` | 不使用已下载的文件，重新下载并安装 |
| `uninstall` | `dvm uninstall ` | 卸载指定的版本 |
| `use` | `dvm use` | 将指定的版本设置为当前使用的版本，未指定版本将从当前目录下的`.dvmrc`文件中读取 |
| | `dvm use ` | 将指定的版本设置为当前使用的版本 |
| | `dvm use ` | 将指定的别名对应的版本设置为当前使用的版本 |
| `run` | `dvm run [args]` | 运行指定版本Deno，并传递对应的参数 |
| `alias` | `dvm alias ` | 为指定版本设置别名 |
| `unalias` | `dvm unalias ` | 删除指定的别名 |
| `current` | `dvm current` | 显示当前使用的Deno版本 |
| `ls` | `dvm ls` | 显示所有当前已安装的版本及别名 |
| `list` | `dvm list` | 与`ls`相同 |
| `ls-remote` | `dvm ls-remote` | 显示所有可安装的版本 |
| `list-remote` | `dvm list-remote` | 与`ls-remote`相同 |
| `which` | `dvm which` | 显示指定版本Deno安装的目录，未指定版本将从当前目录下的`.dvmrc`文件中读取 |
| | `dvm which current` | 显示当前使用的版本Deno安装的目录 |
| | `dvm which ` | 显示指定版本Deno安装的目录 |
| `clean` | `dvm clean` | 清除下载及版本信息缓存 |
| `deactivate` | `dvm deactivate` | 取消当前shell中活跃的Deno |
| `doctor` | `dvm doctor` | 列出存在问题的版本（未安装成功/版本号错误） |
| | `dvm doctor --fix` | 扫描并修复存在问题的版本 |
| `upgrade` | `dvm upgrade` | 更新DVM |
| `purge` | `dvm purge` | 卸载DVM |
| `help` | `dvm help` | 打印帮助信息 |
更多信息请参考[dvm wiki](https://github.com/ghosind/dvm/wiki)。
### 可选参数
| 参数 | 描述 |
|:------:|:------------|
| `-q`, `--quiet` | 安静模式，大大减少输出的数量，只保留了少数必要的输出 |
| `--color` | 以色彩模式运行，输出的文本不再单调 |
| `--no-color` | 以默认颜色输出 |
| `--verbose` | 打印debug信息 |
## 如何卸载DVM
### 使用`purge`命令
DVM `v0.3.2`及以上版本提供了`purge`命令，该命令可被用于卸载DVM本身，它将移除DVM所在的目录以及Shell环境配置文件中的相关内容。若您的DVM版本低于`v0.3.2`，请通过下面手工卸载的方法卸载。
### 手工卸载
DVM所有的文件都保存在`$DVM_DIR`变量指定的目录下，若需要卸载DVM，只需删除`$DVM_DIR`指定的目录即可。
```sh
rm -rf "$DVM_DIR"
```
除文件目录外，DVM将配置信息写入了Shell环境配置文件中（如`.bashrc`或`.zshrc`，根据具体使用的Shell种类决定），您可编辑对应的文件删除下列几行代码：
```sh
# Deno Version Manager
export DVM_DIR="$HOME/.dvm"
[ -f "$DVM_DIR/dvm.sh" ] && . "$DVM_DIR/dvm.sh"
[ -f "$DVM_DIR/bash_completion" ] && . "$DVM_DIR/bash_completion"
```
## 许可
本项目通过MIT许可发布，查看LICENSE文件获取更多信息。