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 目录。

相关推荐
北南京海2 小时前
[Linux]进程地址空间
linux·运维·服务器
yzx9910133 小时前
服务器生成图片
运维·服务器
liulilittle5 小时前
C++ TAP(基于任务的异步编程模式)
服务器·开发语言·网络·c++·分布式·任务·tap
caolib7 小时前
无需云服务器的内网穿透方案 -- cloudflare tunnel
运维·服务器·内网穿透·tunnel·cloudflared
誰能久伴不乏8 小时前
Linux系统调用概述与实现:深入浅出的解析
linux·运维·服务器
程序员学习随笔8 小时前
Linux进程深度解析(2):fork/exec写时拷贝性能优化与exit资源回收机制(进程创建和销毁)
linux·运维·服务器
-SGlow-8 小时前
MySQL相关概念和易错知识点(2)(表结构的操作、数据类型、约束)
linux·运维·服务器·数据库·mysql
代码改变世界ctw9 小时前
Linux内核设计与实现 - 第14章 块I/O层
linux·运维·服务器
Dreams_l9 小时前
网络编程2(应用层协议,传输层协议)
运维·服务器·网络
誰能久伴不乏12 小时前
Linux如何执行系统调用及高效执行系统调用:深入浅出的解析
java·服务器·前端