NVS —— js 实现的node版本管理工具

NVS (Node Version Switcher)

NVS 是一个跨平台的 Node.js 的版本切换工具，并且 NVS 本身是用Node.js[1]编写的。

这个工具显然是受到其他 Node.js 版本管理器工具的启发，特别是nvm[2]，它借鉴了很多思想和一些命令行语法。

以下是基本的设置说明。有关设置 NVS 的更多细节和选项，请参阅设置页面。[3]

Windows

windows 的 MSI 安装包可以从NVS releases page on GitHub[4]这里获得。 你也可以通过chocolatey[5]安装:

choco install nvs

Mac, Linux

指定安装路径，克隆 repo，并输入安装命令：

export NVS_HOME="$HOME/.nvs"
git clone https://gitee.com/wsz7777/nvs "$NVS_HOME"
. "$NVS_HOME/nvs.sh" install

这个nvs.sh是向环境变量中添加nvs的 shell 方法. 执行这个脚本后，你就可以在命令行中直接使用nvs了。请添加这个install命令至~/.bashrc,~/.profile, 或者~/.zshrc文件中。以便该nvs功能在你的 shell 中可用.

对于 ksh, 这个脚本nvs.sh需要添加到~/.kshrc中，或者是$ENV的地方。

CI 支持

NVS can be used in a CI environment[6]可以在 Travis CI 中使用。去使用 NVS 测试下载任何版本的 Node.js 环境。

基础使用

下载最新版本的 Node.js：

$ nvs add latest

下载 lts 版本的 Node.js：

$ nvs add lts

运行nvs use去选择 Node.js 的版本

$ nvs use lts
PATH += ~/.nvs/node/6.9.1/x64

使用nvs link添加默认的 Node.js 版本：

$ nvs link lts

Command 介绍

[version]和[filter]是用来描述版本的，有以下一些情况

大概是这样，可以自行发掘更多用法。

有关每个命令的更多详细信息请参阅文档[7]

互动菜单

不带参数调用时，将nvs显示一个交互式菜单，用于切换和下载 Node.js 版本。

NVS 使用console-menu[8], 最初 console-menu 是为该项目编写的，然后单独发布。

VS Code 支持

Visual Studio Code 可以使用 NVS 选择启动或调试时要使用的 Node.js 版本。在launch.json（.vscode位于项目根文件夹中的文件夹中）中，添加"runtimeArgs"带有 NVS 版本字符串的"runtimeExecutable"属性 ，以及指向nvs.cmd（Windows）或nvs（Mac, Linux）。(如果 NVS 不在 VS Code 的 PATH 环境变量中，您可能需要指定一个绝对路径，例如"${env:HOME}/.nvs/nvs")

配置示例：launch.json使用 VS Code 使用 NVS 启动 Node.js 版本 6.10:

  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "program": "${file}",
      "args": [ ],
      "runtimeArgs": [ "6.10" ],
      "windows": { "runtimeExecutable": "nvs.cmd" },
      "osx": { "runtimeExecutable": "nvs" },
      "linux": { "runtimeExecutable": "nvs" }
    },
  ]

或者，从中删除版本字符串，"runtimeArgs"从.node-version文件或文件夹中获取版本。有关更多详细信息，请参见NVS VS Code 文档[9]或者执行命令nvs help vscode.

配置 remotes

nvs remote命令允许配置多个命名的下载位置。NVS 分别管理来自不同远程位置的版本，因此没有版本冲突的风险。默认情况下，只有一个远程指向 Node.js 官方版本：

$ nvs remote
default  node
node     https://npm.taobao.org/mirrors/node/

这样就可以从其他来源获得构建。以下命令序列为 nightly 添加了一个远程 remote，列出了 nightly ，并添加了一个构建：

$ nvs remote add nightly https://nodejs.org/download/nightly/
$ nvs lsr nightly/13
nightly/13.1.1-nightly20191120c7c566023f
...
$ nvs add nightly/13

添加其他 remote:

nvs remote add iojs https://iojs.org/dist/
nvs remote add chakracore https://nodejs.org/download/chakracore-release/

别名

别名是指远程名称和语义版本的组合。（不对处理器体系结构进行别名。）设置别名时，可以省略远程名称，在这种情况下，别名是指默认的远程。在其他任何命令中，都可以使用别名代替版本字符串。

$ nvs alias myalias 6.7.0
$ nvs alias
myalias default/6.7.0
$ nvs run myalias --version
v6.7.0
$ nvs which myalias
~/.nvs/node/6.7.0/x64/bin/node
$ nvs which myalias/32
~/.nvs/node/6.7.0/x86/bin/node

别名也可以引用本地目录[10]，从而使 NVS 可以切换到 Node.js 的本地私有版本。

根据目录自动切换版本

在 Bash 或 PowerShell 中，NVS 可以在更改目录时自动切换当前 Shell 中的 Node.js 版本。默认情况下，此功能处于禁用状态。使它运行nvs auto on。之后，无论何时cd或pushd在包含.node-version或.nvmrc[11]文件的目录下，NVS 都会相应地自动切换 Node.js 版本，并在必要时下载新版本。当您cd到达目录上方没有目录.node-version或.nvmrc文件的目录时，将还原默认（链接）版本（如果有）。

~$ nvs link 6.9.1
~/.nvs/default -> ~/.nvs/node/6.9.1/x64
~$ nvs use
PATH += ~/.nvs/default/bin
~$ nvs auto on
~$ cd myproject
PATH -= ~/.nvs/default/bin
PATH += ~/.nvs/node/4.6.1/x64/bin
~/myproject$ cd ..
PATH -= ~/.nvs/node/4.6.1/x64/bin
PATH += ~/.nvs/default/bin

Windows 命令提示符中不提供此功能。请用 PowerShell。

手动切换使用.node-version

如果您的外壳与自动切换不兼容，或者您 希望手动切换但仍利用其中的任何一个.node-versionor.nvmrc文件，则可以nvs use使用该版本运行，也可以auto直接运行nvs auto.

$ nvs use auto

相当于

$ nvs auto

如何运行的

Bootstrapping node

NVS 使用特定于平台的shell程序代码是比较少的，这些代码通过自动下载 Node.js 的私有副本来引导工具。引导代码仅是 Windows 命令脚本，Windows powershell 脚本和几十行的 POSIX shell 脚本。除引导程序外，shell 脚本还用于将 PATH 更改导出到调用 shell（单独的 Node.js 进程无法执行）。但是，所有用于查询可用版本，下载和安装 Node.js 以及匹配 npm ，切换版本/体系结构/引擎，卸载，解析和更新 PATH 等的代码都可以用 JavaScript 编写，并且大多数都是以跨平台的方式编写的。

版本切换

NVS 下载 Node.js 版本在NVS_HOME环境变量指定的目录下，或者在NVS_HOME未设置的 NVS 工具目录下。例如，每个构建都位于基于远程名称，语义版本和体系结构的子目录中node/6.7.0/x64.

当您使用nvs use一个版本时， 当前shell的会更新PATH为包括该版本的bin目录.

全局模块

与 NVS 安装的 Node.js 一起使用npm install -gornpm link与之配合使用时，将安装全局模块或将其链接到特定于版本的目录中。（NVS 清除NPM_CONFIG_PREFIX可能已设置的任何环境变量。）这意味着，在 NVS 切换版本时，它也在切换可用的全局模块集。该nvs migrate命令可以将这些全局模块从一个 Node.js 版本迁移到另一 Node.js 版本。

Symbolic 链接

nvs link命令在$NVS_HOME/default指向指定版本（或命令时的当前版本）的位置创建符号目录链接PATH。当需要在其他地方配置固定路径时，这很有用。

在非 Windows 平台上，如果存在链接，则提供nvs.sh脚本来源的新外壳程序也将设置PATH为包括默认版本。在 Windows 上，PATH环境变量在用户配置文件中更新，因此新的 Shell 将使用默认版本。

nvs ls命令列出所有本地 Node.js 版本，并使用标记当前路径中的版本>，并使用标记默认（链接的）版本（如果有）#。这些可以相同或不同。例如：

  node/4.5.0/x64
 #node/4.6.0/x64
 >node/6.7.0/x64

系统 linking

如果$NVS_HOME在诸如/usr/localor%ProgramFiles%,nvs link命令还会链接到众所周知的 Node.js 系统位置。（仅当尚无系统安装的 Node.js 时才允许这样做。）

• 在非 Windows 平台上，为node创建符号链接/usr/local/bin,npm以及具有可执行任何全球安装的 Node.js 模块。请注意，在安装或卸载包含可执行文件的全局模块之后，可能需要再次运行nvs link以更新全局链接。使用 NVS 链接不同版本的 Node.js（具有不同的全局模块）会相应地更新所有链接。
• 在 Windows 上，在创建符号目录链接%ProgramFiles%\Nodejs，并将该目录添加到系统PATH中。

当$NVS_HOME指向非系统目录时，将跳过此系统链接功能，因为在系统目录中创建到用户文件的符号链接是错误的。

依赖关系

除了自动下载的节点的私有副本之外，NVS 没有任何外部依赖关系。运行时 JS 软件包的相关性很小，并且已在存储库中签入，以避免npm install在引导时需要。

参考资料

[1]

Node.js: http://nodejs.org/

[2]

nvm: https://github.com/creationix/nvm

[3]

有关设置 NVS 的更多细节和选项，请参阅设置页面。: https://gitee.com/wsz7777/nvs/tree/gitee/doc/SETUP.md

[4]

NVS releases page on GitHub: https://github.com/wsz7777/nvs/releases

[5]

chocolatey: https://chocolatey.org/

[6]

NVS can be used in a CI environment: https://gitee.com/wsz7777/nvs/tree/gitee/doc/CI.md

[7]

请参阅文档: https://gitee.com/wsz7777/nvs/tree/gitee/doc

[8]

console-menu: https://gitee.com/wsz7777/console-menu

[9]

NVS VS Code 文档: https://gitee.com/wsz7777/nvs/tree/gitee/doc/VSCODE.md

[10]

别名也可以引用本地目录: https://gitee.com/wsz7777/nvs/tree/gitee/doc/ALIAS.md#aliasing-directories

[11]

.nvmrc: https://github.com/nvm-sh/nvm#nvmrc

[12] 原文链接：https://github.com/jasongin/nvs/blob/master/LICENSE.txt

- END -