为什么JavaScript能跑在服务器端
提到JavaScript，大多数人第一反应是浏览器脚本语言，用来做表单校验、页面交互这些活儿。但实际上，JavaScript只是一门编程语言，它能否运行在服务器端，取决于有没有一个合适的运行时环境。浏览器里的JavaScript依赖的是浏览器提供的引擎，比如Chrome的V8引擎负责解析和执行代码，再加上BOM和DOM这些浏览器提供的API，才能操作网页。
Node.js的本质就是把V8引擎从浏览器里抽出来，重新封装成一套可以在操作系统上直接运行的环境。它把浏览器提供的DOM API替换成了文件系统操作、网络请求、进程管理等服务器端能力。这样一来，同一门语言既能写前端页面，也能写后端接口、命令行工具，甚至桌面应用。对于前端开发者来说，这意味着不需要额外学一门后端语言，就能处理完整的服务器端逻辑。
在正式安装之前，可以先确认一下自己电脑上是否已经有Node.js。打开终端或者命令行工具，输入node -v，如果返回版本号说明已经装过了，直接跳到后面的内容即可。如果提示命令不存在，那就跟着下面的步骤一步步来。
Node.js安装的完整流程
安装的第一步是下载安装包。访问Node.js官网，会看到两个版本供选择：LTS版本和Current版本。LTS是长期支持版，稳定性更好，适合生产环境和绝大多数开发者；Current包含最新特性，但可能不够稳定。对于初学者，无脑选LTS版本就行。官网会自动识别你的操作系统，Windows用户下载msi安装包，macOS用户下载pkg安装包。
下载完成后，Windows用户直接双击msi文件，一路点击下一步即可。安装过程中有一个选项是勾选Add to PATH，这个一定要保持勾选状态，它的作用是把node命令加入系统环境变量，否则安装完终端里认不到node命令。macOS用户除了pkg安装包，也可以用Homebrew安装，执行一条命令就能搞定。
# macOS下使用Homebrew安装Node.js brew install node@20 # 或者使用官方pkg安装包后验证安装 node -v npm -v
安装完成后，重新打开一个终端窗口，依次执行node -v和npm -v。如果两个命令都能正确返回版本号，说明Node.js和自带的npm包管理器都安装成功了。npm是用来安装第三方库的工具，后续开发中会频繁用到它。
写第一个服务器端JavaScript程序
环境装好了，接下来验证一下服务器端运行JavaScript到底是怎么回事。新建一个文件夹，在里面创建一个名为app.js的文件，写入几行代码，然后用node命令执行它。你会看到代码直接在终端输出结果，全程没有浏览器的参与，这就是服务器端运行JavaScript最直观的体验。
// app.js
// 引入Node.js内置的http模块
const http = require('http');
// 创建一个服务器，监听3000端口
const server = http.createServer((req, res) => {
res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
res.end('Hello, 这是运行在服务器端的JavaScript');
});
server.listen(3000, () => {
console.log('服务器已启动，访问 http://127.0.0.1:3000');
});在文件所在目录执行node app.js，终端会打印出服务器已启动的提示。此时打开浏览器访问127.0.0.1的3000端口，就能看到返回的文字。这个例子虽然简单，但已经是一个真正意义上的HTTP服务器了，它能接收请求并返回响应，和用Java、Python写的后端服务在工作原理上没有任何区别。
除了写Web服务，node命令还可以直接执行任意JavaScript代码。比如在终端输入node回车，会进入一个交互式环境（REPL），可以当场输入代码立即看到执行结果，用来验证某个API的用法非常方便。
安装过程中常见的错误与解决办法
错误一：node不是内部或外部命令。这是Windows用户遇到频率最高的问题，原因通常是环境变量没有配置正确。先检查安装时是否勾选了Add to PATH选项。如果漏勾了，可以手动配置：打开系统属性里的环境变量设置，在Path变量中添加Node.js的安装目录，默认是C:\Program Files\nodejs\，保存后重新打开终端再试。注意一定要重开终端窗口，旧窗口不会读取新的环境变量。
错误二：npm安装依赖特别慢或者直接超时。默认的npm源服务器在国外，国内访问速度不理想。解决办法是把源切换到国内镜像，比如淘宝镜像，一条命令即可完成切换，切换后安装速度会有质的提升。
# 切换npm源到国内镜像 npm config set registry https://registry.npmmirror.com # 查看当前使用的源，确认是否切换成功 npm config get registry
错误三：权限不足导致安装失败。在Linux或macOS上全局安装包时，可能会碰到EACCES权限错误。不建议直接用sudo暴力解决，更好的做法是把npm的全局安装路径改到用户目录下，这样以后所有全局安装都不需要管理员权限。
# 创建用户级目录并配置npm全局路径 mkdir ~/.npm-global npm config set prefix '~/.npm-global' # 把路径加入环境变量（以bash为例） echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc
错误四：多个项目需要不同Node版本。实际开发中经常碰到老项目要求Node 14，新项目要求Node 20的情况。这时候推荐安装nvm（Node版本管理器），它可以在多个版本之间自由切换，互不干扰。Windows用户使用nvm-windows，macOS和Linux用户使用原生的nvm，安装后通过nvm install和nvm use两条命令就能完成版本管理。
写在最后的学习建议
环境搭建只是第一步，但它的重要性往往被低估。一个干净、稳定、版本可控的环境，能让你在后续学习中少踩很多莫名其妙的坑。建议初学者从一开始就养成用nvm管理版本、用国内镜像加速依赖安装的习惯。
至于学什么，Node.js内置的文件模块、path模块、http模块是基础，理解事件循环和非阻塞IO的机制是核心。有了这些基础后，可以上手Express或Koa这类Web框架，逐步做出自己的接口服务。前端和后端的边界在Node.js出现后被大大模糊了，掌握服务器端JavaScript，等于给自己的技术栈多开了一扇门。
Node.js服务器端JavaScript安装教程修改时间：2026-09-05 23:15:40