Node.js 版本管理工具 n 的入门指南与问题解决

2026-01-20 02:02:03作者：鲍丁臣Ursa

项目地址：https://gitcode.com/gh_mirrors/n1/n

项目基础介绍

n 是一个由 TJ Holowaychuk 开发的简单的 Node.js 版本管理器，它允许用户通过命令行交互式地下载和切换不同的 Node.js 版本。该工具专为简化版本管理而设计，不依赖于子shell或复杂的配置。支持 macOS、Linux 系统以及 Windows Subsystem for Linux，并且是用 Bash 脚本编写的，尽管并不强制要求终端使用 Bash。

主要编程语言: Shell

新手使用时需特别注意的问题及解决步骤

问题一：权限问题安装 n

新用户可能会遇到因无权写入全局npm目录而导致的安装失败。

解决步骤:

获取权限: 执行以下命令创建缓存文件夹并改变其所有权。
```
sudo mkdir -p /usr/local/n
sudo chown -R $(whoami) /usr/local/n
```

确保必要目录存在并更改它们的所有权:

sudo mkdir -p /usr/local/{bin,lib,include,share}
sudo chown -R $(whoami) /usr/local/{bin,lib,include,share}

安装 n: 使用 sudo 或设置自定义安装路径以避免权限问题。

sudo npm install -g n 或者 设置环境变量N_PREFIX指向可写目录后再执行npm install -g n

问题二：多版本共存导致的环境冲突

在有多个Node.js版本的情况下，可能不小心使用了错误的Node版本运行项目。

解决步骤:

查看可用版本:
```
n
```
切换到所需版本:
```
n [version]
```
例如，切换到Node.js 14.17.0，执行 n 14.17.0。

问题三：未正确保留npm版本导致的问题

默认情况下，安装新Node.js版本会覆盖npm版本，这可能导致与现有项目的npm包管理器兼容性问题。

解决步骤:

保留当前npm版本: 在安装新的Node.js之前，先全局安装最新npm版本。
```
npm install -g npm@latest
```
使用 --preserve 安装Node.js以保持npm版本不变: 当使用n安装Node.js时，添加-p或--preserve选项来保留已有的npm版本。
```
npm install -g n
n -p [version]
```

遵循以上步骤，新手可以更顺利地使用 n 来管理和切换不同的Node.js版本，避免常见的安装和环境配置问题。

项目地址：https://gitcode.com/gh_mirrors/n1/n

登录后查看全文