Node.js 起步指南

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境，它让 JavaScript 可以脱离浏览器在服务器端运行。Node.js 采用事件驱动、非阻塞 I/O 模型，使其轻量且高效，非常适合构建数据密集型的实时应用。其包管理工具 npm 是全球最大的开源库生态系统，提供了海量的可复用模块。

官网地址：https://nodejs.org/

Node.js 的安装

下载安装包

访问 Node.js 官网下载页 根据操作系统选择对应的安装包（推荐选择 LTS 版本以保证稳定性）。

安装 Node.js

双击安装包，按提示进行安装。可自定义安装路径（例如 D:\nodejs），其他配置保持默认即可，一路 Next 直到完成。

配置 npm 全局路径

*可选，用于避免占用 C 盘空间

npm 是 Node.js 自带的包管理器，默认会将全局安装的包放在 C:\Users\用户名\AppData\Roaming\npm 下，久而久之会占用 C 盘空间。建议修改全局路径到其他盘符。

• 在 Node.js 安装目录下创建两个文件夹：node_global 和 node_cache。

• 打开命令提示符（cmd），执行以下命令配置路径：

  npm config set prefix "D:\nodejs\node_global"
  npm config set cache "D:\nodejs\node_cache"
  

• 配置环境变量：

  • 新建系统变量 NODE_PATH，值为 D:\nodejs\node_global\node_modules。
  • 编辑用户变量 Path，添加 D:\nodejs\node_global。

注意：修改环境变量后，需要重新打开命令提示符或重启电脑，配置才能生效。可通过 npm config get prefix 和 npm config get cache 验证配置是否成功。

验证安装

打开命令提示符，输入以下命令，若能显示版本号则安装成功：

node -v
npm -v

Node.js 的卸载

若需卸载 Node.js，请按以下步骤彻底清除：

1. 通过控制面板卸载：在“程序和功能”中找到 Node.js 并卸载。
2. 删除安装目录：手动删除 Node.js 的安装文件夹（如 D:\nodejs）。
3. 删除残留文件：
   • 检查并删除 C:\Users\用户名\AppData\Roaming\npm 和 C:\Users\用户名\AppData\Roaming\npm-cache 文件夹。
   • 若之前修改了 npm 全局路径，还需删除自定义的 node_global 和 node_cache 文件夹（如 D:\nodejs\node_global 和 D:\nodejs\node_cache）。
4. 清理环境变量：删除之前添加的 NODE_PATH 变量及 Path 中的相关条目。

Node.js 常用命令

命令	说明
node -v 或 node --version	查看 Node.js 版本
node	进入 Node.js 交互式环境（REPL）
node <文件名>	执行指定 JavaScript 文件
node --inspect <文件名>	启动调试模式运行文件
where node（Windows）	查看 Node.js 安装路径

npm 常用命令

npm 是 Node.js 的默认包管理器，用于安装、管理项目依赖。

命令	说明
npm -v 或 npm --version	查看 npm 版本
npm init	初始化项目，生成 package.json 文件（可加 -y 快速生成）
npm install	根据 package.json 安装所有依赖
npm install <包名>	安装指定包到当前项目（生产依赖）
npm install <包名> --save-dev	安装指定包到当前项目（开发依赖）
npm install -g <包名>	全局安装指定包
npm uninstall <包名>	卸载本地包
npm uninstall -g <包名>	卸载全局包
npm update	更新所有包到符合 package.json 限制的最新版本
npm list	列出已安装的依赖（可加 -g 查看全局）
npm outdated	检查过时的包
npm publish	发布自己的包到 npm 仓库
npm cache clean --force	清理 npm 缓存

配置 npm 镜像源

国内使用 npm 官方源可能较慢，可切换至国内镜像：

# 设置为淘宝镜像
npm config set registry https://registry.npmmirror.com

# 查看当前镜像源
npm config get registry

# 单次安装使用指定镜像
npm install <包名> --registry=https://registry.npmmirror.com

其他国内镜像源

除了淘宝镜像，以下国内镜像源也可选用：

镜像源名称	镜像源地址
华为云	https://mirrors.huaweicloud.com/repository/npm/
腾讯云	https://mirrors.cloud.tencent.com/npm/
中科大	https://mirrors.ustc.edu.cn/npm/
阿里云（官方已迁移至 npmmirror）	https://registry.npmmirror.com

设置方式同上，例如使用华为云镜像：

npm config set registry https://mirrors.huaweicloud.com/repository/npm/

nrm — npm 镜像源管理工具

nrm 是一个可以快速切换、测试 npm 镜像源的工具。

安装 nrm

npm install -g nrm

全局安装可能需要管理员权限（macOS/Linux 使用 sudo）。

常用命令

命令	说明
nrm ls	列出所有可用的镜像源，当前使用的会标 *
nrm use <源名称>	切换到指定源（如 taobao、npm）
nrm add <源名称> <源地址>	添加自定义源
nrm del <源名称>	删除指定源
nrm test <源名称>	测试指定源的响应速度
nrm current	显示当前使用的源

使用 nrm 可以方便地在不同镜像源之间切换，例如：

nrm use taobao   # 切换到淘宝镜像
nrm test         # 测试所有源的响应时间