如何修改npm的全局安装路径?

修改 npm 的全局安装路径可以通过以下步骤完成,确保全局包(使用 -g 安装的模块)和缓存文件存储到自定义路径。以下是详细步骤:

1. 创建自定义路径的目录

在目标路径下创建两个文件夹,分别用于存储全局模块和缓存文件:

2. 配置 npm 的全局路径和缓存路径

使用 npm config 命令修改全局安装路径和缓存路径:

复制代码
# 设置全局模块的安装路径(prefix)
npm config set prefix "D:\soft\node_repository\node_global"

# 设置缓存路径(cache)
npm config set cache "D:\soft\node_repository\node_cache"

3. 验证配置是否生效

执行以下命令检查配置是否成功:

复制代码
# 查看全局安装路径
npm config get prefix  

# 查看缓存路径
npm config get cache   

4. 配置环境变量(关键步骤)

为了让系统识别全局安装的命令(如 npm 全局包的可执行文件),需要将新路径添加到 环境变量 中:

⑴:添加 PATH 环境变量

Windows 操作步骤

右击此电脑 → 点击"属性" → "高级系统设置" → "环境变量"。

在"系统变量"中找到 Path 变量,点击"编辑"。

新增以下路径:

D:\soft\node_repository\node_global(全局模块的根目录)

D:\soft\node_repository\node_global\node_modules\.bin(全局模块的可执行文件目录)

点击确定保存。

⑵.(可选但推荐):设置 NODE_PATH

如果全局模块需要被 Node.js 项目直接引用,添加 NODE_PATH 环境变量:

  • 在"系统变量"中新建变量:
    • 变量名:NODE_PATH
    • 变量值:D:\soft\node_repository\node_global\node_modules

5. 测试配置

⑴ 安装一个全局包

复制代码
npm install -g pm2  # 例如安装 pm2
  • 检查安装路径:D:\soft\node_repository\node_global\node_modules下应出现 pm2 目录。

⑵.验证命令是否生效

复制代码
pm2 -v  # 应显示 pm2 的版本号

6. 其他可选配置(提升体验)

⑴ 设置淘宝镜像加速下载

复制代码
npm config set registry https://registry.npmmirror.com

⑵.检查完整配置

复制代码
npm config list  # 查看所有 npm 配置




prefix(全局路径)和 cache(缓存路径)的区别

(1) prefix(全局路径,如 D:\node_global

  • 存储内容 :已安装的全局 npm 包的最终版本

  • 作用 :存放通过 npm install -g 安装的完整包文件(如 node_modules 目录下的模块)和可执行命令(如 webpackpm2)。

  • 文件结构示例

    复制代码
    D:\node_global\
    ├── node_modules\
    │   ├── [email protected]\
    │   ├── [email protected]\
    │   └── ...
    └── node_modules\.bin\
        ├── executable1.exe
        └── executable2.sh

(2) cache(缓存路径,如 D:\node_cache

  • 存储内容 :下载的包的原始压缩文件.tgz)和元数据(如哈希校验值、索引文件)。

  • 作用:临时存储下载的包,供后续安装时快速复用,避免重复下载。

  • 文件结构示例

    复制代码
    D:\node_cache\
    ├── _cacache\
    │   ├── content-v2\  # 存储原始 .tgz 包(二进制文件)
    │   ├── index-v5\    # 存储元数据(如包的哈希值、下载时间等)
    │   └── tmp\         # 临时文件
    └── ...其他配置文件

2. 为什么不会"下载两份"?

npm 的安装流程如下,不会重复下载包

  1. 下载阶段

    • 当执行 npm install -g package 时,npm 首先检查 cacheD:\node_cache)中是否有该包的压缩文件(.tgz)。
    • 如果没有,则从远程仓库(如 npmjs.com 或淘宝镜像)下载一次 ,并将压缩包存入 cache
    • 如果已有缓存,则直接使用已有的 .tgz 文件。
  2. 安装阶段

    • cache 中的 .tgz 文件解压并安装到 prefixD:\node_global,生成可执行的模块和命令。
    • 同一个包的 .tgz 文件只会在 cache 中存储一份 ,而安装后的解压文件会存放到 prefix

3. 具体例子说明

假设你全局安装了 pm2

  • 缓存路径 D:\node_cache
    • 存储 pm2 的原始 .tgz 文件(如 pm2-5.3.0.tgz)和元数据。
  • 全局路径 D:\node_global
    • 存储解压后的 pm2 模块文件(如 node_modules/pm2)和可执行文件(如 pm2.cmd)。

关键点

  • .tgz 文件只存在于 cache,而解压后的文件存在于 prefix
  • 如果再次安装 pm2,npm 会直接从 cache 中读取 .tgz,无需重新下载,但会再次解压到 prefix(如果版本不同或需要更新)。

4. 为什么需要分开这两个路径?

  • 职责分离
    • cache 是临时存储区,用于加速安装。
    • prefix 是最终安装路径,存放可直接使用的模块和命令。
  • 灵活性
    • 可以将 cache 放在高速存储(如 SSD),prefix 放在大容量存储(如 HDD)。
    • 可以独立清理 cache(节省空间),而不会影响已安装的全局模块。

5. 总结

  • prefix :存放已安装的全局模块(长期保留)。
  • cache :存放下载的原始包文件(临时缓存)。
  • 不会重复下载 :同一个包的 .tgz 文件只会在 cache 中存储一份,安装时仅解压到 prefix
相关推荐
小小小小宇2 小时前
手写 zustand
前端
Hamm2 小时前
用装饰器和ElementPlus,我们在NPM发布了这个好用的表格组件包
前端·vue.js·typescript
小小小小宇3 小时前
前端国际化看这一篇就够了
前端
大G哥3 小时前
PHP标签+注释+html混写+变量
android·开发语言·前端·html·php
whoarethenext3 小时前
html初识
前端·html
小小小小宇3 小时前
一个功能相对完善的前端 Emoji
前端
m0_627827523 小时前
vue中 vue.config.js反向代理
前端
Java&Develop3 小时前
onloyoffice历史版本功能实现,版本恢复功能,编辑器功能实现 springboot+vue2
前端·spring boot·编辑器
白泽talk4 小时前
2个小时1w字| React & Golang 全栈微服务实战
前端·后端·微服务
摆烂工程师4 小时前
全网最详细的5分钟快速申请一个国际 “edu教育邮箱” 的保姆级教程!
前端·后端·程序员