0

0

如何在Linux系统中安装Node.js和npm?快速搭建前端开发环境的教程

雪夜

雪夜

发布时间:2025-09-01 08:25:01

|

653人浏览过

|

来源于php中文网

原创

使用NVM安装Node.js和npm是Linux下最推荐的方式,它支持多版本管理、避免权限问题。1. 通过curl或wget安装NVM;2. 执行source命令激活NVM;3. 使用nvm install node安装最新版Node.js;4. 运行node -v和npm -v验证安装成功。

如何在linux系统中安装node.js和npm?快速搭建前端开发环境的教程

在Linux系统上安装Node.js和npm,最推荐且灵活的方式是使用Node Version Manager (NVM)。它允许你轻松安装和切换多个Node.js版本,避免了系统级安装可能带来的冲突和权限问题,尤其适合前端开发者管理不同项目所需的Node环境。

解决方案

为了在Linux系统上快速且灵活地搭建Node.js和npm环境,我个人强烈建议使用Node Version Manager (NVM)。这不仅能让你轻松安装最新版本的Node.js,还能让你在不同项目之间无缝切换Node.js版本,这在前端开发中简直是救星。

1. 安装NVM

首先,我们需要下载并安装NVM。打开你的终端,执行以下命令:

立即学习前端免费学习笔记(深入)”;

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

或者,如果你更喜欢

wget

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

这个脚本会将NVM克隆到你的用户目录下(通常是

~/.nvm
),并尝试修改你的shell配置文件(如
~/.bashrc
,
~/.zshrc
,
~/.profile
等),以便NVM在每次启动终端时都能加载。

2. 激活NVM

安装脚本执行完毕后,你需要重新加载你的shell配置,或者干脆关闭并重新打开终端。 如果你不想重启终端,可以手动执行:

source ~/.bashrc  # 或者你的shell配置文件,比如 ~/.zshrc

验证NVM是否安装成功,可以输入:

nvm --version

如果显示版本号,那就说明Nvm已经准备就绪了。

3. 安装Node.js和npm

现在,你可以用NVM安装Node.js了。安装最新稳定版Node.js的命令是:

nvm install node

这条命令会自动安装最新LTS(长期支持)版本的Node.js,并附带相应的npm。

如果你需要安装特定版本的Node.js,比如18.x系列:

nvm install 18

或者精确到某个小版本:

nvm install 18.17.0

安装完成后,你需要告诉NVM使用哪个版本的Node.js。如果你只安装了一个版本,它通常会自动设置为默认。但为了确保,可以执行:

nvm use node  # 使用最新安装的版本

或者:

nvm use 18  # 使用18.x系列版本

为了让这个版本在每次打开新终端时都自动生效,你可以将其设置为默认:

nvm alias default node  # 将当前使用的Node.js版本设置为默认

4. 验证安装

最后,检查Node.js和npm是否都已正确安装并可用:

node -v
npm -v

它们应该分别显示对应的版本号。

为什么NVM是前端开发者的首选?

我个人在多年的开发实践中,几乎从未后悔过选择NVM来管理我的Node.js环境。它带来的便利性远超直接通过系统包管理器安装。最核心的原因在于版本管理的灵活性。前端项目往往依赖于特定版本的Node.js,比如有些老项目可能还在用Node 14,而新项目则要求Node 18或更高。如果直接系统安装,你只能有一个全局版本,这会让你在不同项目之间切换时陷入“版本冲突”的泥潭,轻则报警告,重则项目根本跑不起来。

NVM完美解决了这个问题。它允许你在同一台机器上安装并维护多个Node.js版本,并且可以轻松地通过

nvm use 
命令在不同版本间切换。这意味着你可以为每个项目配置其所需的Node.js版本,从而保证开发环境的稳定性和一致性。此外,使用NVM安装的Node.js和npm,其全局包(如
create-react-app
,
vue-cli
等)也会安装在NVM管理的用户目录下,避免了使用
sudo
带来的权限问题,让你的开发体验更加顺畅和安全。

安装后如何验证Node.js和npm并启动你的第一个前端项目?

成功安装Node.js和npm后,验证工作是必不可少的一步。这就像你组装好一台电脑后,总要开机看看能不能点亮屏幕一样。

1. 验证Node.js和npm版本

在终端中输入:

魔珐星云
魔珐星云

无需昂贵GPU,一键解锁超写实/二次元等多风格3D数字人,跨端适配千万级并发的具身智能平台。

下载
node -v
npm -v

如果它们都显示了版本号,比如

v18.17.0
9.6.7
,那就说明Node.js运行时和npm包管理器都已成功安装并处于可用状态。这基本意味着你的基础环境已经就绪。

2. 启动你的第一个前端项目

有了Node.js和npm,你就可以开始初始化一个前端项目了。以一个简单的React项目为例:

首先,选择一个你想要创建项目的目录,比如进入你的

Documents
文件夹:

cd ~/Documents

然后,使用

create-react-app
工具(如果没安装,它会提示你安装或用
npx
直接运行)来创建一个新的React项目:

npx create-react-app my-first-react-app

npx
是一个Node.js包执行工具,它允许你直接运行npm仓库中的包,而不需要全局安装它们,这在很多场景下非常方便。

创建过程可能需要一些时间,因为它会下载React项目的模板和所有依赖。完成后,进入项目目录:

cd my-first-react-app

最后,启动开发服务器:

npm start

这通常会在你的默认浏览器中打开

http://localhost:3000
,显示一个带有React logo的页面。恭喜你,你的前端开发环境已经成功搭建并运行起来了!

Linux环境下Node.js和npm的常见问题与优化策略

在Linux上使用Node.js和npm进行开发,虽然NVM已经解决了大部分版本管理的问题,但偶尔还是会遇到一些小插曲。理解这些常见问题及其解决策略,能让你在遇到困难时少走弯路。

1. PATH环境变量问题

有时,即使NVM显示Node.js已安装,你在终端输入

node
npm
时,系统仍然提示“command not found”。这通常是
PATH
环境变量没有正确配置导致的。NVM的安装脚本会尝试修改你的shell配置文件(如
~/.bashrc
,
~/.zshrc
),但有时可能没有生效,或者你使用的是一个非标准shell。

解决策略:

  • 手动检查配置文件: 打开你的
    ~/.bashrc
    ~/.zshrc
    文件,确保其中包含类似
    export NVM_DIR="$HOME/.nvm"
    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
    这样的行。
  • 手动加载NVM: 如果每次开机都遇到问题,可以尝试在每次打开新终端时手动执行
    source ~/.bashrc
    (或对应文件),直到你找到根本原因并修复配置文件。
  • 确保NVM路径在PATH前面: 有时系统自带的Node.js版本(通过
    apt
    yum
    安装)会优先被找到。NVM的配置应该确保其路径在系统路径之前加载。

2. npm包安装速度慢或失败

在国内,由于网络环境的复杂性,直接从npm官方源下载包可能会非常慢,甚至出现超时失败的情况。

解决策略:

  • 使用淘宝NPM镜像: 这是最常见的解决方案。你可以通过以下命令将npm的注册表设置为淘宝镜像:
    npm config set registry https://registry.npmmirror.com

    如果你需要恢复到官方源,可以执行:

    npm config set registry https://registry.npmjs.org/
  • 使用
    cnpm
    cnpm
    是一个完整的npm客户端,它默认使用淘宝镜像。你可以全局安装它:
    npm install -g cnpm --registry=https://registry.npmmirror.com

    之后就可以用

    cnpm install
    代替
    npm install

  • 清理npm缓存: 有时损坏的缓存也会导致安装问题。
    npm cache clean --force

3. Node.js进程占用CPU或内存过高

在进行大型前端项目构建(如Webpack打包)时,Node.js进程可能会占用大量CPU和内存。

解决策略:

  • 增加系统资源: 如果是虚拟机或容器环境,考虑分配更多的CPU核心和内存。
  • 优化构建配置: 检查你的Webpack或其他构建工具的配置,是否有不必要的插件或优化空间。例如,使用
    happypack
    thread-loader
    进行多线程编译。
  • 监控与调试: 使用
    top
    htop
    等工具监控进程资源占用,结合Node.js的
    --inspect
    参数进行性能分析。
  • 升级Node.js版本: 新的Node.js版本通常会有性能上的改进。

4. 全局包权限问题

虽然NVM安装的Node.js通常不会有

sudo
权限问题,但如果你不小心通过系统包管理器安装了Node.js,或者尝试全局安装包时没有NVM的上下文,可能会遇到权限错误。

解决策略:

  • 坚持使用NVM: 确保你所有的Node.js相关操作都在NVM管理的环境下进行。
  • 不要用
    sudo npm install -g
    这是一个常见的反模式,它会污染你的全局环境并可能导致后续的权限问题。如果你确实需要将某个包安装到系统路径,请考虑使用NVM安装Node.js,然后用
    npm install -g

这些小技巧和解决思路,希望能帮助你在Linux上更顺畅地进行Node.js和前端开发。毕竟,一个稳定高效的开发环境,才是我们高效产出的基石。

相关专题

更多
curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

437

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

175

2023.10.30

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

482

2023.08.10

Python 多线程与异步编程实战
Python 多线程与异步编程实战

本专题系统讲解 Python 多线程与异步编程的核心概念与实战技巧,包括 threading 模块基础、线程同步机制、GIL 原理、asyncio 异步任务管理、协程与事件循环、任务调度与异常处理。通过实战示例,帮助学习者掌握 如何构建高性能、多任务并发的 Python 应用。

143

2025.12.24

java多线程相关教程合集
java多线程相关教程合集

本专题整合了java多线程相关教程,阅读专题下面的文章了解更多详细内容。

5

2026.01.21

C++多线程相关合集
C++多线程相关合集

本专题整合了C++多线程相关教程,阅读专题下面的的文章了解更多详细内容。

11

2026.01.21

Java 并发编程高级实践
Java 并发编程高级实践

本专题深入讲解 Java 在高并发开发中的核心技术,涵盖线程模型、Thread 与 Runnable、Lock 与 synchronized、原子类、并发容器、线程池(Executor 框架)、阻塞队列、并发工具类(CountDownLatch、Semaphore)、以及高并发系统设计中的关键策略。通过实战案例帮助学习者全面掌握构建高性能并发应用的工程能力。

63

2025.12.01

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

510

2023.06.20

菜鸟裹裹入口以及教程汇总
菜鸟裹裹入口以及教程汇总

本专题整合了菜鸟裹裹入口地址及教程分享,阅读专题下面的文章了解更多详细内容。

0

2026.01.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Rust 教程
Rust 教程

共28课时 | 4.7万人学习

PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.6万人学习

Git 教程
Git 教程

共21课时 | 2.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号