Node.js 完全安装与使用指南:Windows 平台详细教程

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时,让开发者能够使用 JavaScript 编写服务器端和跨平台应用程序。本指南将详细介绍如何在 Windows 系统上安装、配置和使用 Node.js,包括版本管理、核心命令和常见问题排查。

1. Node.js 基础知识

1.1 什么是 Node.js

Node.js 是一个开源的基于事件驱动的 JavaScript 运行时,适用于构建可扩展的网络应用程序。它使开发者能够在服务器端和跨平台环境中使用 JavaScript 语言。

1.2 Node.js 主要特点

  • 基于 V8 引擎:使用 Chrome V8 引擎执行 JavaScript,提供高性能
  • 单线程事件驱动:采用单线程、事件驱动、非阻塞I/O模型,适合高并发应用
  • 包生态系统:通过 NPM(Node Package Manager)提供丰富的第三方包
  • 跨平台:支持 Windows、macOS、Linux 等多个平台

1.3 Node.js 适用场景

  • Web 应用程序后端
  • 实时应用(如聊天系统)
  • API 服务开发
  • 命令行工具
  • 跨平台桌面应用开发

2. 安装方式比较

2.1 Windows 安装 Node.js 的主要方式

安装方式 优点 缺点 适用场景
官方 MSI 安装包 图形界面,简单直观 难以管理多个版本 简单使用,不需要版本切换
Node.js Windows 包管理器 (nvm-windows) 可安装多个版本,切换方便 需要额外配置环境变量 需要使用不同版本 Node.js 的开发场景
预编译二进制文件 直接下载解压即可使用 需手动配置环境变量 临时使用或特定场景
Windows 包管理器 (winget) 集成系统包管理 可能有版本限制 现代 Windows 系统,喜欢使用包管理器

"在Windows上,nvm-windows是一个常用的Node.js版本管理工具,它允许你安装和管理多个Node.js版本。"

3. 使用 nvm-windows 管理 Node.js 版本

nvm-windows 是 Windows 平台下管理多个 Node.js 版本的最佳工具,类似于 Unix 系统上的 nvm。以下是详细的安装和使用指南。

3.1 nvm-windows 安装

  1. 下载 nvm-windows 安装包

  2. 安装 nvm-windows

    复制代码
    # 解压下载的文件
    # 运行安装程序
    nvm-setup.exe

    安装向导会引导你完成路径设置等配置 。

3.2 nvm-windows 核心命令

命令 描述 示例
nvm list available 查看可安装的 Node.js 版本 nvm list available
nvm install <版本号> 安装指定版本 Node.js nvm install 18.17.0
nvm use <版本号> 切换到指定版本 Node.js nvm use 18.17.0
nvm list 查看已安装的 Node.js 版本 nvm list
nvm uninstall <版本号> 卸载指定版本 Node.js nvm uninstall 16.15.1
nvm root 查看或设置 Node.js 安装根目录 nvm root

"nvm-windows 是一个在Windows下管理多个Node.js版本的工具,通过它可以安装和切换不同版本的Node.js"

3.3 通过 nvm-windows 安装和管理 Node.js

  1. 查看可安装的版本

    复制代码
    nvm list available
  2. 安装 LTS 版本

    复制代码
    nvm install lts/*  # 安装最新的 LTS 版本

    或指定版本:

    复制代码
    nvm install 18.17.0
  3. 切换 Node.js 版本

    复制代码
    nvm use 18.17.0

    切换后,当前命令行窗口及其子进程将使用指定版本的 Node.js。

  4. 设置默认版本

    复制代码
    nvm use --delete-on-fail 18.17.0

    或通过创建符号链接设置默认版本:

    复制代码
    nvm alias default 18.17.0

"首先查询当前的 LTS 版本号码:nvm list available,然后安装最新的稳定 LTS 版本 Node.js"

4. 官方 MSI 安装包安装 Node.js

官方 MSI 安装包是 Node.js 官方为 Windows 系统提供的图形化安装程序,适合不需要频繁切换版本的用户。

4.1 下载并安装

  1. 访问 Node.js 官方下载页面:nodejs.org/en/download
  2. 根据你的系统架构(x86 或 x64)选择并下载相应的 MSI 安装包
  3. 双击运行下载的 MSI 文件,按照安装向导提示完成安装

4.2 验证安装

打开命令提示符或 PowerShell,输入以下命令:

复制代码
node -v
npm -v

如果显示了版本号,表示安装成功。

"Node.js 官方针对不同系统已经给出了非常详细的安装命令,你可以根据不同平台系统选择你需要的 Node.js 安装命令脚本。"

5. 使用预编译二进制文件安装

预编译二进制文件是官方提供的直接可用的 Node.js 可执行文件,适合临时使用或特定场景。

5.1 下载并使用

  1. 访问 Node.js 官方下载页面
  2. 选择 "Prebuilt Binaries" 部分
  3. 根据系统架构下载相应的 Node.exe 文件
  4. 将 Node.exe 复制到系统路径或项目目录中使用

"Windows 二进制文件 (.exe) 安装:点击 'Prebuilt Binaries' 选项下载二进制文件,双击 Node.exe 运行"

6. 使用 Windows 包管理器 (winget) 安装

Windows 10/11 的现代包管理器 winget 也提供了安装 Node.js 的方式。

6.1 通过 winget 安装

复制代码
winget install -e --id=Node.js基金会.Node.js-LTS

这将安装 Node.js 的长期支持版本。

"使用操作系统的包管理器(如 npm、apt、yum、brew 等)来安装 Node.js"

7. Node.js 核心命令与基本使用

7.1 版本管理命令

命令 功能
node -v 查看当前 Node.js 版本
npm -v 查看当前 npm 版本
node --version 查看 Node.js 版本的详细信息
npm view npm version 查看最新版本的 npm

7.2 项目初始化与包管理

  1. 初始化新项目

    复制代码
    npm init

    该命令会创建一个 package.json 文件,用于管理项目的依赖和配置。

  2. 安装包

    复制代码
    npm install <package_name>

    全局安装包:

    复制代码
    npm install -g <package_name>
  3. 更新包

    复制代码
    npm update <package_name>

    全局更新包:

    复制代码
    npm update -g <package_name>
  4. 卸载包

    复制代码
    npm uninstall <package_name>

    全局卸载包:

    复制代码
    npm uninstall -g <package_name>

7.3 脚本运行

package.json 中定义脚本后,可以使用以下命令运行:

复制代码
npm run <script_name>

7.4 其他常用命令

命令 功能
node 启动 Node.js REPL 交互式解释器
node app.js 运行名为 app.js 的 Node.js 应用
npm config list 查看 npm 配置
npm cache clean --force 强制清理 npm 缓存
npx <command> 临时使用 npm 包中的命令

"50 个必备的 Node.js 命令大全" 涵盖了更多高级命令和用法

8. 配置与优化

8.1 配置 npm 源

为了加速 npm 包的下载,可以配置国内镜像源:

复制代码
npm config set registry https://registry.npmmirror.com

8.2 环境变量配置

如果安装后无法使用 Node.js 命令,可能需要手动配置环境变量:

  1. 打开「控制面板」->「系统」->「高级系统设置」
  2. 点击「环境变量」
  3. 在系统变量中找到「Path」,点击编辑
  4. 添加 Node.js 安装路径(如 C:\Program Files\nodejs
  5. 重新打开命令行工具验证

"如果你获得以上输出结果,说明你已经成功安装了 Node.js"

9. 常见问题排查

9.1 安装相关问题

问题 解决方案
安装后命令行无法使用 Node.js 检查环境变量是否正确配置,重启命令行工具
nvm 安装 Node.js 失败 尝试使用短路径安装,如 C:\nvm
npm 包安装失败 检查网络连接,配置镜像源,清理缓存并重试

9.2 版本兼容性问题

当遇到特定包安装失败时:

复制代码
# 查看当前节点版本
node -v

# 使用 nvm 切换到不同版本
nvm use <version>

# 重新安装依赖
npm install

"node-sass 安装错误。使用 cnpm 进行安装,可以解决常见的 node-sass 遇到错误问题"

9.3 npm 无法使用的问题

如果安装后 npm 无法使用:

复制代码
# 检查 npm 是否安装
where npm

# 修复 npm 路径
node -e "process.stdout.write(require('npm').npmcli.bin)"

# 重新配置环境变量

"Node.js 安装后 npm 无法使用的全面排查与解决方案" 需要检查版本兼容性、环境变量配置、权限等问题

10. Node.js 开发实践

10.1 创建基本应用

创建一个简单的 Node.js HTTP 服务器:

复制代码
// app.js
const http = require('http');

const server = http.createServer((req, res) => {
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain');
  res.end('Hello, Node.js!\n');
});

server.listen(3000, () => {
  console.log('Server is running on port 3000');
});

运行应用:

复制代码
node app.js

然后在浏览器访问 http://localhost:3000 查看结果。

10.2 使用 ES6+ 语法

Node.js 支持大部分 ES6+ 语法,但可以使用以下方法启用更多功能:

复制代码
node --harmony script.js

或在 package.json 中配置:

复制代码
{
  "name": "my-app",
  "version": "1.0.0",
  "engines": {
    "node": ">=18.0.0"
  }
}

10.3 模块化开发

Node.js 支持多种模块系统:

  1. CommonJS(默认)

    // 导出模块
    module.exports = {
    sayHello: () => {
    console.log('Hello!');
    }
    };

    // 引用模块
    const myModule = require('./my-module');
    myModule.sayHello();

  2. ES 模块

    // 导出模块
    export function sayHello() {
    console.log('Hello!');
    }

    // 引用模块
    import { sayHello } from './my-module';
    sayHello();

注意:使用 ES 模块时需要指定 .mjs 文件扩展名或在 package.json 中添加 "type": "module"

11. 命令行工具开发

Node.js 是开发命令行工具的理想选择。以下是创建简单 CLI 工具的示例:

复制代码
// cli-tool.js
#!/usr/bin/env node

console.log('This is my CLI tool!');

const args = process.argv.slice(2);

if (args.length === 0) {
  console.log('No arguments provided');
  process.exit(1);
}

console.log('Arguments:', args.join(', '));

添加可执行权限并使用:

复制代码
chmod +x cli-tool.js
./cli-tool.js arg1 arg2

在 Windows 上不需要添加可执行权限,可直接运行:

复制代码
node cli-tool.js arg1 arg2

"Node.js 作为目前最热门的开发工具之一,怎样使用它开发命令行程序,是 Web 开发者应该掌握的技能"

12. 总结

本文详细介绍了在 Windows 系统上安装和使用 Node.js 的多种方式,重点介绍了 nvm-windows 这一版本管理工具的使用方法。通过遵循本文提供的步骤和命令,你可以:

  1. 选择适合的 Node.js 安装方式
  2. 使用 nvm-windows 管理多个 Node.js 版本
  3. 掌握 Node.js 核心命令和基本使用方法
  4. 解决常见的安装和配置问题
  5. 开始开发基于 Node.js 的应用

通过这些知识,你可以在 Windows 环境中高效地使用 Node.js 进行开发,并灵活应对不同项目的需求。

相关推荐
私人珍藏库2 小时前
[Windows] 随手剪-视频合并工具 v0.12多种格式多段视频50多种转场效果
windows·音视频
行者..................4 小时前
手动编译 OpenCV 4.1.0 源码,生成 ARM64 动态库 (.so),然后在 Petalinux 中打包使用。
前端·webpack·node.js
用户31187945592184 小时前
copyparty.exe 怎么用?局域网文件共享工具安装与运行教程
windows
迪丽热爱5 小时前
解决【npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1,因为在此系统上禁止运行脚本。】问题
前端·npm·node.js
千叶寻-6 小时前
package.json详解
前端·vue.js·react.js·webpack·前端框架·node.js·json
zhengjianyang&1236 小时前
美团滑块-[behavior] 加密分析
javascript·经验分享·爬虫·算法·node.js
【上下求索】9 小时前
学习笔记092——Windows如何将 jar 包启动设置成系统服务
java·windows·笔记·学习·jar
Liu1bo10 小时前
【Windows】如何管理电脑磁盘文件,保持简洁
windows
梅孔立11 小时前
本地多版本 Node.js 切换指南:解决 Vue nodejs 等项目版本冲突问题
前端·vue.js·node.js