Node.js 安装及环境配置指南

文章目录

• • 前言
  • 一、Node.js 概述
  • 二、准备工作
  • 三、Node.js 安装
  • • 1. Windows 系统
    • 2. macOS 系统
    • 3. Linux 系统
  • 四、环境配置
  • 五、常用命令和技巧
  • 六、常见问题及解决方案
  • 结语

---

前言

随着互联网技术的不断发展，JavaScript 已经成为了一门全栈编程语言。Node.js 的出现，使得 JavaScript 不仅可以用于浏览器端，还可以用于服务器端的开发。本文将为您提供一个保姆级的教程，详细介绍如何在 Windows、macOS 和 Linux 系统上安装 Node.js 并进行环境配置，帮助您快速上手这一强大的工具。

---

一、Node.js 概述

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境。它使用事件驱动、非阻塞 I/O 模型，使其轻量又高效，非常适合用于数据密集型实时应用的开发。Node.js 使得开发人员能够使用 JavaScript 编写服务器端代码，实现前后端技术栈的统一。

二、准备工作

在安装Node.js之前，请确保手里的计算机满足以下条件：

• 操作系统支持：Node.js 支持 Windows、macOS、Linux 等多种操作系统。
• 网络连接：安装过程中可能需要从网络下载文件。
• 磁盘空间：根据安装的 Node.js 版本和附加组件，可能需要几百 MB 到几 GB 的磁盘空间。

三、Node.js 安装

1. Windows 系统

下载 Node.js

1. 访问 Node.js 官方网站 https://nodejs.org/。
2. 选择适合您操作系统的版本下载。对于初学者，推荐下载 LTS 版本，因为它是长期支持版本，更加稳定。
3. 点击下载页面上的 “下载 Node.js (LTS)” 按钮，即可开始下载安装包。

运行安装程序

1. 下载完成后，双击 .msi 文件启动安装向导。
2. 在安装向导中，可以选择安装路径，默认为 C:Program Files odejs。
3. 请务必勾选 “Add to PATH” 选项，这将自动为 Node.js 添加环境变量，方便后续的命令行操作。
4. 按照安装向导的提示完成安装。

验证安装

1. 打开命令提示符（可以通过快捷键 Win+R 输入 cmd 后回车打开）。
2. 输入 node -v 查看 Node.js 版本，输入 npm -v 查看 npm（Node.js 包管理器）版本，以此来确认安装是否成功。

手动配置环境变量（如果未自动添加）

1. 右键点击“此电脑”或“我的电脑”，选择“属性”。
2. 点击“高级系统设置”。
3. 在“系统属性”窗口中，点击“环境变量”按钮。
4. 在“系统变量”部分，找到 Path 变量，点击“编辑”。
5. 在“编辑环境变量”窗口中，点击“新建”，然后添加 Node.js 的安装路径（例如 C:Program Files odejs）。
6. 点击“确定”保存更改。
7. 重新打开命令提示符，再次输入 node -v 和 npm -v 验证安装。

2. macOS 系统

通过 Homebrew 安装

1. 首先，确保您的 Mac 已经安装了 Homebrew，这是一个非常流行的包管理器。如果没有安装，可以在终端中运行以下命令来安装 Homebrew：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 安装完成后，在终端中执行以下命令来安装 Node.js：

   brew install node
   

3. 安装完成后，同样可以使用 node -v 和 npm -v 命令来验证安装。

使用 Node Version Manager (NVM)

1. NVM 是一个允许用户轻松安装多个 Node.js 版本的工具。首先，通过以下命令安装 NVM：

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
   

2. 安装完成后，重启终端，然后使用以下命令安装最新的 LTS 版本：

   nvm install --lts
   

3. 使用以下命令切换到安装的版本：

   nvm use --lts
   

4. 再次使用 node -v 和 npm -v 命令验证安装。

3. Linux 系统

Ubuntu/Debian

1. 打开终端，更新软件包列表：

   sudo apt update
   

2. 安装 Node.js：

   sudo apt install nodejs
   

3. 安装 npm：

   sudo apt install npm
   

4. 验证安装：

   node -v
   npm -v
   

CentOS/RHEL

1. 打开终端，更新软件包列表：

   sudo yum update
   

2. 安装 EPEL 仓库：

   sudo yum install epel-release
   

3. 安装 Node.js：

   sudo yum install nodejs
   

4. 验证安装：

   node -v
   npm -v
   

四、环境配置

安装完成后，您可能还需要对 Node.js 的环境进行一些额外的配置，以更好地适应您的开发需求。

设置全局模块目录

1. 默认情况下，全局安装的 npm 包会被放置在 /usr/local 目录下。如果您希望更改这个位置，可以通过设置 prefix 配置项来实现。

2. 创建一个新的全局模块目录：

   mkdir ~/.npm-global
   

3. 设置 npm 的全局模块目录：

   npm config set prefix '~/.npm-global'
   

4. 将新的全局模块目录添加到 PATH 环境变量中，以便可以直接调用这些模块。编辑 ~/.profile 或 ~/.bashrc 文件，添加以下内容：

   export PATH=~/.npm-global/bin:$PATH
   

5. 使配置生效

   source ~/.profile
   

   或

   source ~/.bashrc
   

配置npm镜像

1. 为了加快 npm 包的下载速度，可以切换到国内的镜像源，如淘宝 NPM 镜像。使用以下命令设置：

   npm config set registry https://registry.npmmirror.com
   

2. 验证设置：

   npm config get registry
   

创建项目

1. 创建一个新的项目文件夹：

   mkdir my-project
   cd my-project
   

2. 初始化项目：

   npm init
   

   按照提示填写项目信息，或者直接使用以下命令生成默认的 package.json 文件：

   npm init -y
   

3. 开始安装项目依赖，例如安装 Express 框架：

   npm install express
   

五、常用命令和技巧

基本命令

• node -v：查看 Node.js 版本。
• npm -v：查看 npm 版本。
• npm install ：安装指定的 npm 包。
• npm uninstall ：卸载指定的 npm 包。
• npm list：列出已安装的 npm 包。
• npm update：更新所有已安装的 npm 包。
• npm outdated：检查哪些已安装的 npm 包有新版本可用。

运行 Node.js 应用

1. 创建一个简单的 Node.js 应用文件 app.js：

   const http = require('http')
   
   const hostname = '127.0.0.1'
   const port = 3000
   
   const server = http.createServer((req, res) => {
     res.statusCode = 200
     res.setHeader('Content-Type', 'text/plain')
     res.end('Hello World
   ')
   })
   
   server.listen(port, hostname, () => {
     console.log(`Server running at http://${hostname}:${port}/`)
   })
   

2. 在终端中运行该应用：

   node app.js
   

3. 打开浏览器，访问 http://127.0.0.1:3000，应该能看到 “Hello World” 的输出。

调试 Node.js 应用

1. 使用 node inspect 命令启动调试模式：

   node inspect app.js
   

2. 在浏览器中打开 chrome://inspect，点击 “Open dedicated DevTools for Node”，然后选择您的应用进行调试。

六、常见问题及解决方案

问题 1：无法访问 Node.js 官方网站

• 解决方案：尝试使用科学上网工具，或者直接从国内镜像源下载 Node.js 安装包。例如，阿里云提供 Node.js 的镜像下载：https://npm.taobao.org/mirrors/node/

问题 2：安装过程中报错

• 解决方案：检查您的网络连接是否正常，确保防火墙或安全软件没有阻止安装程序的运行。如果问题仍然存在，可以尝试重新下载安装包并重新安装。

问题 3：npm 安装包失败

• 解决方案：检查您的网络连接，确保没有被代理或防火墙阻止。可以尝试切换到国内的 npm 镜像源，如淘宝 NPM 镜像。

问题 4：Node.js 版本冲突

• 解决方案：使用 Node Version Manager (NVM) 来管理多个 Node.js 版本。通过 nvm install 和 nvm use 命令轻松切换不同的 Node.js 版本。

---

结语

通过上述步骤，您应该已经成功地在您的计算机上安装并配置好了 Node.js 环境。Node.js 提供了一个强大的平台，使您能够在服务器端使用 JavaScript 进行开发。无论是构建简单的 API 接口，还是复杂的企业级应用，Node.js 都能提供出色的性能和支持。希望本文能为您开启 Node.js 之旅提供帮助。随着实践的深入，您将逐渐掌握更多高级特性和最佳实践，成为一名优秀的 Node.js 开发者。