如何在 Mac 上安装 Node.js 18.19.1

简介

本教程将指导您如何在 mac 系统上安装 Node.js 18.19.1。Node.js是一个基于Chrome V8引擎的JavaScript运行时环境，它使得开发者可以使用JavaScript来编写服务器端代码。

前置要求

Mac 操作系统
稳定的网络连接
管理员权限

安装方法

通过官方网站安装

从Node.js官方网站下载并安装，这是最直接和推荐的方式。

1. 下载安装包

访问Node.js官方网站下载对应版本。

https://nodejs.org/download/

2. 运行安装程序

打开下载的.pkg文件，按照安装向导的提示进行安装。

通过版本管理器安装

使用nvm(Node Version Manager)安装，这种方式可以方便地管理多个Node.js版本。

1. 安装nvm

首先安装nvm工具：

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

2. 重新加载配置

安装完成后，需要重新加载终端配置：

source ~/.bashrc

3. 安装Node.js

使用nvm安装Node.js 18.19.1：

nvm install 18.19.1

4. 使用指定版本

设置要使用的Node.js版本：

nvm use 18.19.1

通过包管理器安装

使用系统的包管理器安装，这种方式更容易进行版本管理和更新。

1. 使用Homebrew安装

使用Homebrew包管理器安装Node.js。

brew install node@18

验证安装

1. 验证Node.js安装

验证Node.js是否安装成功：

node --version

2. 验证npm安装

验证npm（Node包管理器）是否安装成功：

npm --version

3. 测试Node.js环境

创建一个简单的JavaScript文件来测试Node.js环境：

echo "console.log('Hello from Node.js')" > test.js
node test.js

如果看到输出"Hello from Node.js"，说明Node.js环境正常。

基本使用示例

运行JavaScript文件

创建并运行一个简单的JavaScript文件

// hello.js
console.log('Hello, Node.js!');

Hello, Node.js!

使用npm初始化项目

创建一个新的Node.js项目

npm init -y

{
  "name": "my-node-project",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC"
}

安装依赖包

使用npm安装项目依赖

npm install express

+ express@4.18.2
added XX packages in Ys

创建HTTP服务器

使用Express创建一个简单的Web服务器

// app.js
const express = require('express');
const app = express();
const port = 3000;

app.get('/', (req, res) => {
  res.send('Hello World!');
});

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

Server running at http://localhost:3000

常见问题

问题：node command not found

解决方案：确保软件已正确安装并添加到系统PATH中。可能需要重启终端或系统。

问题：安装过程中遇到权限错误

解决方案：确保您有管理员权限。在Windows上以管理员身份运行命令提示符，在Mac/Linux上使用sudo。

问题：npm安装全局包时报错

解决方案：可能是权限问题，尝试使用sudo（Linux/Mac）或以管理员身份运行（Windows），或配置npm使用自定义目录。

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

问题：无法访问npm源

解决方案：检查网络连接，或者切换到其他npm镜像源。

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

使用技巧

使用.nvmrc文件指定项目的Node.js版本

使用package-lock.json确保依赖版本一致

在package.json中定义常用的npm脚本

使用nodemon实现开发时的自动重启

合理使用环境变量管理配置

使用npm audit检查依赖的安全性

总结

现在您已经成功安装了Node.js 18.19.1，并了解了基本的使用方法。Node.js生态系统非常丰富，您可以使用npm安装数以百万计的包来扩展您的应用功能。建议您多看看官方文档和社区资源，以便更好地使用Node.js进行开发。