NPM 的路径配置

发布 | 2024-08-26 | Tools

NPM 是 Node.js 的包管理器,用于管理 JavaScript 包和依赖。在使用 NPM 时,通常需要配置以下两个主要路径:

  • 全局安装路径(prefix:NPM 全局安装的包会存放在这个路径下。
  • 缓存路径(cache:NPM 下载的包缓存会存放在这个路径下,以加快后续安装速度。

路径配置说明

Windows 系统

  • 设置全局安装路径:

    npm config set prefix "NODEJS路径\node_global"
  • 设置缓存路径:

    npm config set cache "NODEJS路径\node_cache"
  • 设置 PATH 环境变量:
    需要将全局安装路径和 Node.js 的可执行文件路径添加到 PATH 环境变量中。
    步骤:

    1. 打开“系统属性”对话框(Win + Pause > 高级系统设置 > 环境变量)。
    2. 在“用户变量”或“系统变量”中,找到 PATH,点击“编辑”。
    3. 添加以下路径:

      NODEJS路径
      NODEJS路径\node_global
    4. 点击“确定”保存更改。
  • 验证配置:
    打开命令提示符(CMD),执行以下命令验证配置是否成功:

    node -v
    npm -v

macOS/Linux 系统

  • 设置全局安装路径:

    npm config set prefix "$HOME/.npm-global"
  • 设置缓存路径:

    npm config set cache "$HOME/.npm-cache"
  • 设置 PATH 环境变量:
    需要将全局安装路径添加到 PATH 环境变量中。在终端中编辑 ~/.bashrc~/.zshrc 文件(根据使用的 shell 不同):

    export PATH="$HOME/.npm-global/bin:$PATH"

    然后使配置生效:

    source ~/.bashrc  # 或者 source ~/.zshrc
  • 验证配置:
    打开终端,执行以下命令验证配置是否成功:

    node -v
    npm -v

如何取消配置加载

如果你需要取消或重置之前的配置,可以按照以下方式进行:

  • Windows 系统:

    • 打开命令提示符(CMD),执行以下命令:

      npm config delete prefix
      npm config delete cache
    • 打开“系统属性”对话框,删除 PATH 环境变量中与 NPM 相关的路径。
  • MacOS/Linux 系统:

    • 编辑 ~/.npmrc 文件,删除或注释掉 prefixcache 配置:

      # prefix=$HOME/.npm-global
      # cache=$HOME/.npm-cache
    • 编辑 ~/.bashrc~/.zshrc 文件,删除 export PATH 的相关配置。

项目级 NPM 配置

NPM 允许在项目级别配置特定的 NPM 设置,这样不同项目可以使用不同的 NPM 配置。

  • 在项目根目录下创建 .npmrc 文件,并配置你希望为该项目设置的选项。例如:

    prefix=./.npm-global
    cache=./.npm-cache
  • 当你在该项目中执行 NPM 命令时,它将优先使用 .npmrc 中的配置。

常见问题和解决方案

  • NPM 全局命令无法找到:

    • 检查 PATH 环境变量是否正确配置,并确保它包含 npm global 安装路径。
  • npm install 速度慢:

    • 可以配置淘宝 NPM 镜像源以加速安装:

      npm config set registry https://registry.npm.taobao.org
  • 如何查看当前 NPM 配置:

    • 使用以下命令查看当前配置:

      npm config list

标签
NMP

© 著作权归作者所有

本文由 趣代码Blog 创作,采用 知识共享署名4.0 国际许可协议进行许可,本站文章除注明转载/出处外,均为本站原创或翻译,转载前请务必署名。

评论关闭