零基础教程：Ubuntu小白也能懂的Node.js安装指南

原创于 2025-12-16 12:39:11 发布 · 738 阅读

11 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

快速体验

打开 InsCode(快马)平台 https://www.inscode.net

输入框内输入如下内容：

请创建一个面向Linux初学者的Node.js安装教程脚本，要求：1.从打开终端开始引导 2.每个命令都有通俗易懂的解释 3.包含常见错误解决方法 4.最后用简单的HTTP服务器示例验证安装。输出格式为Markdown，包含必要的截图占位符和emoji提示。

点击'项目生成'按钮，等待项目生成完整后预览效果

示例图片

作为一个刚刚接触Linux的新手，在Ubuntu上安装Node.js可能会让人感到有些无从下手。不过别担心，跟着这篇教程一步步来，你也能轻松搞定Node.js的安装，并验证它是否正常工作。

1. 打开终端

在Ubuntu系统中，终端是我们与系统交互的重要工具。你可以通过以下方式打开终端：

使用快捷键 Ctrl + Alt + T
在应用程序菜单中搜索“终端”并点击打开

打开后，你会看到一个带有命令提示符的窗口，这就是我们接下来要操作的地方。

2. 更新系统软件包

在安装任何新软件之前，最好先更新系统现有的软件包。这样可以确保我们安装的Node.js能够兼容当前的系统环境。

在终端中输入以下命令并回车：
```
sudo apt update
```
sudo 表示以管理员权限运行命令
apt 是Ubuntu的包管理工具
update 表示更新软件包列表
系统可能会要求你输入密码。输入时不会显示任何字符（这是正常的安全措施），输入完成后直接回车。
更新完成后，可以运行以下命令升级已安装的软件包：
```
sudo apt upgrade
```

3. 安装Node.js

Ubuntu的默认仓库中可能不是最新版的Node.js，所以我们使用NodeSource提供的仓库来安装最新稳定版。

首先安装curl工具（如果尚未安装）：
```
sudo apt install curl
```

添加NodeSource仓库（以Node.js 18.x为例）：

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -

现在可以安装Node.js和npm（Node.js的包管理器）：
```
sudo apt install -y nodejs
```

4. 验证安装

安装完成后，让我们检查一下是否成功。

查看Node.js版本：
```
node -v
```
这会输出类似 v18.x.x 的版本号。
查看npm版本：
```
npm -v
```
这会输出npm的版本号。

5. 常见问题解决

如果遇到问题，可以尝试以下解决方法：

权限问题：如果在安装过程中遇到权限错误，确保使用sudo命令
版本不匹配：如果安装的Node.js版本太旧，请检查NodeSource仓库是否正确添加
命令未找到：如果node或npm命令不可用，尝试重新安装或重启终端

6. 创建简单的HTTP服务器

让我们用一个简单的例子来验证Node.js是否正常工作。

创建一个新文件server.js：
```
nano server.js
```

输入以下内容（这是一个最简单的Node.js HTTP服务器）：

const http = require('http');

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

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

按Ctrl+X，然后按Y保存文件。

运行服务器：
```
node server.js
```
打开浏览器访问http://localhost:3000，你应该能看到"Hello from Node.js!"的消息。

使用InsCode(快马)平台体验

在InsCode(快马)平台上，你可以直接体验Node.js项目而无需本地安装。平台提供了完整的开发环境，包括代码编辑器和实时预览功能，特别适合想要快速上手Node.js的初学者。

示例图片

我发现使用平台的一键部署功能特别方便，可以立即看到代码的运行效果，省去了本地配置环境的麻烦。对于新手来说，这是个很好的学习工具，能让你专注于代码本身而不是环境配置。

快速体验

打开 InsCode(快马)平台 https://www.inscode.net

输入框内输入如下内容：

请创建一个面向Linux初学者的Node.js安装教程脚本，要求：1.从打开终端开始引导 2.每个命令都有通俗易懂的解释 3.包含常见错误解决方法 4.最后用简单的HTTP服务器示例验证安装。输出格式为Markdown，包含必要的截图占位符和emoji提示。

点击'项目生成'按钮，等待项目生成完整后预览效果

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考