Node.js 安装与配置全攻略:从入门到高效开发

一、安装Node.js

Node.js 官网 下载 https://nodejs.org/zh-cn

一直下一步直到这个页面勾选!!!

二、验证安装是否成功

  1. 检查 Node.js 和 npm 版本

    bash 复制代码
    node -v   # 查看 Node.js 版本
    npm -v    # 查看 npm 版本
    • 如果显示版本号(如 v18.16.0),说明安装成功。

三、配置环境变量(可选,若安装时未自动配置)

如果安装时未勾选 "Add to PATH"(或路径未自动添加),需手动配置环境变量:

  1. 打开环境变量设置
    • 右键点击 此电脑 > 属性 > 高级系统设置 > 环境变量
  2. 添加 Node.js 路径到 Path
    • 系统变量 中找到 Path,点击 编辑
    • 添加 Node.js 的安装路径(如 C:\Program Files\nodejs 或自定义路径)。
  3. 添加 NODE_PATH(可选)
    • 系统变量 中新建变量:
      • 变量名NODE_PATH
      • 变量值%AppData%\npm\node_modules(或全局模块路径)。

四、配置 npm 全局路径和缓存路径(推荐)

1. 设置全局模块存放路径

默认情况下,npm 会将全局包安装到 C:\Users\[用户名]\AppData\Roaming\npm,可能占用 C 盘空间。可自定义路径:

  1. 创建目录

    • 在安装目录下新建 node_globalnode_cache 文件夹(如 D:\nodejs\node_globalD:\nodejs\node_cache)。
  2. 配置 npm (需管理员权限运行命令行):

    bash 复制代码
    npm config set prefix "D:\nodejs\node_global"    # 全局模块路径
    npm config set cache "D:\nodejs\node_cache"      # 缓存路径
  3. 验证配置

    bash 复制代码
    npm config get prefix    # 应显示自定义的全局路径
    npm config get cache    # 应显示自定义的缓存路径

五、配置 npm 镜像源(加速下载)

由于国际网络问题,建议切换到国内镜像源(如淘宝镜像):

bash 复制代码
# 切换 npm 官方源到淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证是否切换成功
npm config get registry

六、配置项目级环境(可选)

  1. 初始化项目
    在项目根目录下运行:

    bash 复制代码
    npm init -y    # 自动生成 package.json 文件(默认配置)
  2. 安装项目依赖

    bash 复制代码
    npm install <包名>    # 安装本地依赖
    npm install -g <包名> # 安装全局依赖(如 `npm install -g express`)

七、其他注意事项

  1. 权限问题

    • 如果全局安装包时提示权限不足,需以管理员身份运行命令行(右键点击 命令提示符/PowerShell > 以管理员身份运行)。
  2. 清理 npm 缓存

    bash 复制代码
    npm cache clean --force    # 清理缓存(解决安装异常时使用)
  3. 恢复默认配置

    bash 复制代码
    npm config delete registry    # 恢复 npm 默认源

验证配置是否生效

  1. 测试全局包安装

    bash 复制代码
    npm install -g express      # 安装全局包
    node -e "console.log(require('express'))" # 检查是否可引用
  2. 检查路径

    • 全局包应安装到 node_global 目录。
    • 缓存文件应存放在 node_cache 目录。

相关推荐
Mintopia14 小时前
Node.js 中 fs.readFile API 的使用详解
前端·javascript·node.js
无名之逆14 小时前
Rust 开发提效神器:lombok-macros 宏库
服务器·开发语言·前端·数据库·后端·python·rust
rainFFrain15 小时前
单例模式与线程安全
linux·运维·服务器·vscode·单例模式
GalaxyPokemon15 小时前
Muduo网络库实现 [九] - EventLoopThread模块
linux·服务器·c++
xujiangyan_16 小时前
nginx的反向代理和负载均衡
服务器·网络·nginx
咖啡教室16 小时前
nodejs开发后端服务详细学习笔记
后端·node.js
GalaxyPokemon17 小时前
Muduo网络库实现 [十] - EventLoopThreadPool模块
linux·服务器·网络·c++
自由鬼17 小时前
开源虚拟化管理平台Proxmox VE部署超融合
linux·运维·服务器·开源·虚拟化·pve
孤独得猿17 小时前
Qt常用控件第一部分
服务器·开发语言·qt