Node.js 与 npm 环境搭建指南（Windows · 附自定义全局目录）

本指南基于真实配置过程整理，涵盖 Node.js 安装、npm 全局目录自定义、环境变量配置、权限问题解决 以及 验证方法，适用于 Vue / React 等前端开发环境。

📦 一、安装 Node.js

1.1 下载

• 访问 Node.js 官网，选择 LTS 版本（长期支持版）
• 下载 Windows 安装包（.msi 格式）

1.2 安装步骤

1. 运行 .msi 安装程序
2. 点击 Next，勾选 “I accept the terms…”
3. 关键步骤：确保勾选 Add to PATH（自动添加到系统环境变量）
4. 其余选项保持默认，一路 Next 完成安装

1.3 验证安装

打开 命令提示符 (CMD) 或 PowerShell，执行：

node -v   # 应显示版本号，如 v24.15.0
npm -v    # 应显示版本号，如 11.12.1

✅ 若两者均正常输出版本号，说明安装成功。

🗂️ 二、（可选）自定义 npm 全局包与缓存目录

默认情况下，npm 全局包安装在 C:\Users\用户名\AppData\Roaming\npm，缓存位于 C:\Users\用户名\AppData\Local\npm-cache。
若希望更改位置（例如迁移到 D 盘），请按以下步骤操作。

2.1 创建目标文件夹

在目标位置（如 D 盘）创建两个文件夹：

D:\nodeJs\node_global   （存放全局安装的包）
D:\nodeJs\node_cache    （存放缓存）

2.2 配置 npm 使用新路径

npm config set prefix D:\nodeJs\node_global
npm config set cache  D:\nodeJs\node_cache

验证配置：

npm config get prefix   # 应输出 D:\nodeJs\node_global
npm config get cache    # 应输出 D:\nodeJs\node_cache

2.3 将全局包路径添加到系统 PATH

让系统能够找到全局安装的命令（如 vue, cowsay 等）：

1. 右键 “此电脑” → 属性 → 高级系统设置 → 环境变量
2. 在 系统变量 或 用户变量 中找到 Path，点击 编辑
3. 点击 新建，输入 D:\nodeJs\node_global⚠️ 注意：直接添加该目录本身，不是其下的 bin 子目录（Windows 下 npm 将可执行文件直接放在 node_global 根目录）
4. 点击 确定 保存，重启所有命令行窗口（包括 VS Code 终端）

🔐 三、解决权限问题（EPERM）

在自定义目录中安装全局包时，可能遇到：

npm error code EPERM
npm error syscall mkdir
npm error path D:\nodeJs\node_cache\_cacache

这是当前用户对目标文件夹没有写入权限导致的。

方案一：以管理员身份运行命令行（临时）

• 关闭当前命令行，在开始菜单搜索 cmd 或 PowerShell
• 右键 → 以管理员身份运行
• 重新执行 npm install -g <包名>

方案二：修改文件夹权限（一劳永逸）

1. 打开文件资源管理器，找到 D:\nodeJs 文件夹
2. 右键 → 属性 → 安全 选项卡 → 点击 编辑
3. 选择你的用户名（如 Users 或具体账户），勾选 完全控制 → 确定
4. 如果列表中没有你的用户名，点击 添加 → 输入用户名 → 检查名称 → 确定，再赋予完全控制
5. 应用后，普通命令行也可直接安装全局包

方案三：放弃自定义，恢复默认目录（最简单）

npm config delete prefix
npm config delete cache

之后全局包将安装到用户目录，无需管理员权限。

🧪 四、测试全局包安装（以 cowsay 为例）

4.1 安装测试包

npm install -g cowsay

4.2 验证安装位置

where cowsay

应输出你设置的 node_global 路径，例如：

D:\nodeJs\node_global\cowsay
D:\nodeJs\node_global\cowsay.cmd

4.3 运行测试

cowsay Hello

预期输出：

 _______
< Hello >
 -------
        \   ^__^
         \  (oo)\_______
            (__)\       )\/\
                ||----w |
                ||     ||

4.4 测试完毕，卸载

npm uninstall -g cowsay

🧹 五、清理缓存与日志

5.1 清除 npm 缓存（删除已下载的包副本）

npm cache clean --force

警告 using --force Recommended protections disabled. 可忽略，仅表示跳过安全检查。

5.2 手动删除日志文件夹（可选）

缓存清理不会删除 _logs 目录（存放调试日志），可手动删除：

rmdir /s /q D:\nodeJs\node_cache\_logs

删除后 npm 会自动重建。

5.3 完全清空自定义缓存目录（谨慎操作）

rmdir /s /q D:\nodeJs\node_cache
mkdir D:\nodeJs\node_cache

❓ 六、常见问题与解决

📌 七、总结

按照本指南操作，即可在 Windows 上搭建稳定的 Node.js + npm 开发环境，并根据需要自定义全局目录，为前端开发（Vue / React / Angular 等）做好基础准备。