新手向:从零开始Node.js超详细安装、配置与使用指南
什么是Node.js?
简单来说:
Node.js 是一个在服务器端运行 JavaScript 的环境。
以前JavaScript只能做网页特效,现在用它就能开发网站后台、命令行工具甚至桌面应用!
第一步:安装Node.js(多系统详解)
Windows 系统
-
下载安装包:
-
打开官网:https://nodejs.org
-
点击绿色的 \"LTS\" 版本(稳定版)下载(例如:
node-v20.x.x-x64.msi
)
👉 新手别选\"Current\"(尝鲜版)!
-
-
安装过程:
-
双击安装包 → 全部点\"Next\"(默认设置即可)→ 勾选 ✅ \"Automatically install tools\" → 完成安装
-
-
关键一步!
-
安装完成后按
Win + R
输入cmd
打开命令行 -
输入以下命令验证:
node -vnpm -v
正确显示版本号(如
v20.15.0
和10.5.0
)即成功!
-
Mac 系统
方法1(推荐):用 Homebrew
-
安装Homebrew(粘贴到终端)
/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"
2.安装Node.js
brew install node
方法2:直接下载官网的
.pkg
安装包(步骤同Windows)
Linux 系统(Ubuntu为例)
-
打开终端(
Ctrl+Alt+T
) -
依次执行:
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -sudo apt install -y nodejs
验证安装是否成功(3种方法)
验证方式 命令 预期结果 1. 版本检查 node -v
显示版本号(如 v20.15.0) 2. 运行JavaScript node -e \"console.log(\'Hello Node!\')\"
终端打印出 \"Hello Node!\" 3. 进入交互模式 输入 node
→ 回车 → 输入1+1
输出 2
→ 按两次Ctrl+C
退出
配置npm(Node包管理器)
npm是Node.js的“应用商店”,安装后需优化:
解决权限问题(必做!)
避免以后安装包报错:
# 创建全局包安装目录mkdir ~/.npm-global# 配置npm使用此目录npm config set prefix \'~/.npm-global\'# 将目录添加到系统路径echo \'export PATH=~/.npm-global/bin:$PATH\' >> ~/.bashrc # Mac/Linux# Windows:在环境变量中手动添加 `用户变量` → PATH → `%USERPROFILE%\\.npm-global\\bin`
加速下载(小白用户必看)
切换npm镜像到国内源:
npm config set registry https://registry.npmmirror.com
第一个Node.js程序:创建HTTP服务器
-
新建文件
app.js
,用记事本/VSCode打开 -
粘贴代码:
// 1. 导入http模块const http = require(\'http\');// 2. 创建服务器const server = http.createServer((req, res) => { res.writeHead(200, {\'Content-Type\': \'text/html\'}); // 设置响应头 res.end(\'
Hello Node.js!
\'); // 返回HTML内容});// 3. 监听3000端口server.listen(3000, () => { console.log(\'服务器已运行:http://localhost:3000\');});
运行程序:
-
命令行进入文件所在目录
-
输入
node app.js
打开浏览器访问 → http://localhost:3000
页面显示 Hello Node.js! 大标题!
npm 常用命令速查表
npm init -y
npm install lodash
npm install -g nodemon
npm uninstall 包名
npm update
npm list --depth=0
常见问题排查(新手避坑)
-
报错:\'node\' 不是内部命令
→ 重新安装Node.js,勾选 ✅ \"Add to PATH\" 选项 -
npm安装包卡住
→ 换国内镜像:npm config set registry https://registry.npmmirror.com
-
权限错误(Mac/Linux)
→ 命令前加sudo
,或按前文配置npm全局目录 -
端口占用
→ 修改代码中的端口号(如4000
)
下一步学什么?
-
用
npm init
创建项目 -
学习Express框架开发网站
-
用FS模块操作文件
-
部署项目到云服务器
关键记住:
node 文件.js
→ 运行程序
npm install 包名
→ 装插件遇到错误 → 先查版本和环境变量!
动手试试吧!
技术不息,折腾不止!