新手向:从零开始Node.js超详细安装、配置与使用指南

发布于:2025-07-02 ⋅ 阅读:(30) ⋅ 点赞:(0)
什么是Node.js?

简单来说:

Node.js 是一个在服务器端运行 JavaScript 的环境
以前JavaScript只能做网页特效,现在用它就能开发网站后台、命令行工具甚至桌面应用!

第一步:安装Node.js(多系统详解)

 Windows 系统
  1. 下载安装包

    • 打开官网:https://nodejs.org

    • 点击绿色的 "LTS" 版本(稳定版)下载(例如:node-v20.x.x-x64.msi
      👉 新手别选"Current"(尝鲜版)!

  2. 安装过程

    • 双击安装包 → 全部点"Next"(默认设置即可)→ 勾选 ✅ "Automatically install tools" → 完成安装

  3. 关键一步!

    • 安装完成后按 Win + R 输入 cmd 打开命令行

    • 输入以下命令验证:

      node -v
      npm -v

      正确显示版本号(如 v20.15.0 和 10.5.0)即成功!

Mac 系统

方法1(推荐):用 Homebrew

  1. 安装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为例)
  1. 打开终端(Ctrl+Alt+T

  2. 依次执行:

    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服务器

  1. 新建文件 app.js,用记事本/VSCode打开

  2. 粘贴代码:

    // 1. 导入http模块
    const http = require('http');
    
    // 2. 创建服务器
    const server = http.createServer((req, res) => {
      res.writeHead(200, {'Content-Type': 'text/html'}); // 设置响应头
      res.end('<h1>Hello Node.js!</h1>'); // 返回HTML内容
    });
    
    // 3. 监听3000端口
    server.listen(3000, () => {
      console.log('服务器已运行:http://localhost:3000');
    });

运行程序

  • 命令行进入文件所在目录

  • 输入

    node app.js

打开浏览器访问 → http://localhost:3000
页面显示 Hello Node.js! 大标题!

npm 常用命令速查表

命令 作用
npm init -y 快速创建package.json文件
npm install lodash 安装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


 下一步学什么?

  1. 用 npm init 创建项目

  2. 学习Express框架开发网站

  3. 用FS模块操作文件

  4. 部署项目到云服务器


关键记住

  • node 文件.js → 运行程序

  • npm install 包名 → 装插件

  • 遇到错误 → 先查版本和环境变量!

动手试试吧!


技术不息,折腾不止! 


网站公告

今日签到

点亮在社区的每一天
去签到