Linux:安装 Node.js 的技术指南

admin
4
2025-07-23

1、🐧 简述

Node.js是一个基于Chrome V8引擎的JavaScript运行时环境,它让开发者能够在服务器端运行JavaScript代码。本文将详细介绍在Linux系统上安装Node.js的几种方法,并提供实践示例。

image-fpvg.png


2、🧰 安装

✅ 方法1:使用官方二进制包安装(推荐)

这是最简单直接的方法,适用于大多数Linux发行版。

# 首先,访问Node.js官网(https://nodejs.org)查看最新LTS版本
# 然后下载并安装(以16.x为例):

# 下载Node.js二进制包
curl -o node.tar.xz https://nodejs.org/dist/v16.15.0/node-v16.15.0-linux-x64.tar.xz

# 解压到/usr/local目录
sudo tar -C /usr/local --strip-components 1 -xJf node.tar.xz

# 验证安装
node -v
npm -v

✅ 方法2:使用包管理器安装

在Ubuntu/Debian上:

# 使用Ubuntu官方仓库安装(版本可能不是最新的)
sudo apt update
sudo apt install nodejs npm

# 或者使用NodeSource仓库安装最新LTS版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

在CentOS/RHEL上:

# 使用NodeSource仓库
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

✅ 方法3:使用NVM(Node Version Manager)安装

NVM允许你在同一台机器上安装和管理多个Node.js版本。

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

# 重新加载shell配置
source ~/.bashrc  # 或者 ~/.zshrc, ~/.profile等

# 安装Node.js LTS版本
nvm install --lts

# 查看已安装的版本
nvm ls

# 切换Node.js版本
nvm use 16

✅ 验证安装

安装完成后,验证Node.js和npm是否正确安装:

node -v
npm -v
npx -v

🧪 3、实践示例

📄 示例1:创建并运行一个简单的Node.js应用

创建一个新项目目录并初始化:

mkdir my-node-app
cd my-node-app
npm init -y

创建 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');
});

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

运行应用:

node app.js

访问 http://localhost:3000查看结果。

📄 示例2:使用Express框架创建Web应用

安装Express:

npm install express

创建 express-app.js

const express = require('express')
const app = express()
const port = 3000

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

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

运行Express应用:

node express-app.js

📄 示例3:创建一个简单的CLI工具

创建项目并安装依赖:

mkdir my-cli-tool
cd my-cli-tool
npm init -y
npm install commander chalk

创建 cli.js

#!/usr/bin/env node

const { program } = require('commander');
const chalk = require('chalk');

program
  .version('1.0.0')
  .description('A simple CLI tool')
  .option('-n, --name <name>', 'Your name')
  .parse(process.argv);

const options = program.opts();

if (options.name) {
  console.log(chalk.green(`Hello, ${options.name}!`));
} else {
  console.log(chalk.red('Please provide your name with --name option'));
}

package.json中添加bin字段:

{
  "bin": {
    "greet": "./cli.js"
  }
}

全局安装并测试:

npm link
greet --name "Linux User"

📦 4、常见问题解决

权限问题:如果遇到EACCES错误,可以:

🔹 使用nvm安装Node.js(推荐)

🔹 或者更改npm默认目录:

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

版本过旧:如果系统包管理器提供的Node.js版本太旧,建议使用NVM或官方二进制包安装。

npm命令不存在:在某些发行版中,npm需要单独安装:

sudo apt install npm  # Ubuntu/Debian

🔚 5、总结

在Linux上安装Node.js有多种方法,选择哪种方法取决于你的需求:

🔹 需要最新版本:使用官方二进制包或NodeSource仓库

🔹 需要多版本管理:使用NVM

🔹 快速简单:使用系统包管理器

安装完成后,你可以开始开发各种Node.js应用,从简单的脚本到复杂的Web服务。Node.js强大的生态系统和npm包管理器将为你提供丰富的工具和库来加速开发。

希望这篇指南能帮助你在Linux系统上顺利安装和使用Node.js!

动物装饰