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

10,271 阅读6分钟

作者:未见

NVS (Node Version Switcher)

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

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

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

Windows

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

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可以在 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 介绍

命令描述
nvs help <command>获取命令的详细帮助
nvs install初始化并使用 NVS
nvs uninstall从 profile 和 environment 中移除 NVS
nvs --version展示 NVS 版本
nvs add [version]下载某个版本的 Node.js
nvs rm <version>移除某个版本的 Node.js
nvs migrate <fromver> [tover]迁移全局的 node_modules
nvs upgrade [fromver]更新当前环境的 Node.js 至最新版本
nvs use [version]选择使用某个版本的 Node.js
nvs auto [on/off]使用 cwd 自动切换
nvs run <ver> <js> [args...]使用 Node.js 的某个版本的去执行 js 应用
nvs exec <ver> <exe> [args...]使用 Node.js 的某个版本的去执行 可执行文件
nvs which [version]显示 Node.js 的某个版本的二进制文件的路径
nvs ls [filter]展示本地下载的 Node.js 版本列表
nvs ls-remote [filter]列出可下载的 Node.js 版本
nvs lsr [filter]同上
nvs link [version]设置一个软连接指向一个版本,作为默认使用的版本
nvs unlink [version]删除指向默认版本的链接
nvs alias [name] [value]给某个版本设置一个别名
nvs remote [name] [value]设置下载 node 的仓库

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

情况例子
完整的版本号15.14.0、0.6.11
不完整版本号14、15、8
标签lts, latest, Argon
远程安装仓库名node、node/15.12.0 。 如果使用 nvs remote 添加了远程仓库名为 taobao 那就可以使用 taobao、taobao/15.13.0
远程仓库名斜线后的部分lts, 4.6.0, 6/x86, node/6.7/x64

大概是这样,可以自行发掘更多用法有关每个命令的更多详细信息请参阅文档

互动菜单

不带参数调用时,将nvs显示一个交互式菜单,用于切换和下载 Node.js 版本。nvs-menu.gifNVS 使用console-menu, 最初 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 文档或者执行命令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

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

根据目录自动切换版本

在 Bash 或 PowerShell 中,NVS 可以在更改目录时自动切换当前 Shell 中的 Node.js 版本。默认情况下,此功能处于禁用状态。使它运行nvs auto on。之后,无论何时cdpushd在包含.node-version.nvmrc文件的目录下,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在引导时需要。