Skip to content

Node.js配置

笔记修改时间:251215、

NVM: Node.js版本控制

安装nvm&node.js

推荐方法:使用 NVM(Node Version Manager)

这是最干净、最方便的方法,可以管理多个 Node.js 版本。

  1. 安装 NVM-Windows:先卸载当前 Node.js v14(老版本),用图吧工具箱-Geek Uninstaller

  2. 下载安装 NVM-Windows

    访问 GitHub 下载:https://github.com/coreybutler/nvm-windows/releases 下载 nvm-setup.exe并安装

    很重要-安装过程见本笔记:安装过程

  3. 使用 NVM 安装 Node.js v22:以管理员身份运行 PowerShell 或 CMD

    # 查看可用版本
    nvm list available
    
    # 安装 Node.js v22 nvm安装在d盘,node.js也会默认安装到它的d盘目录
    nvm install 22.11.0  # 或直接 nvm install 22
    
    # 使用 v22
    nvm use 22.11.0
    
    # 设置默认版本
    nvm on
    
    # 查看安装位置
    where node
    where npm

到这都没问题的话,就不用看下面的内容了。。。

nvm的环境变量配置

我遇到的问题:我的系统变量中,NVM_HOME的值是D:\Program\Environment\nvm 我的NVM_SYMLINK值是C:\nvm4w\nodejs 这个目录是什么?我的nodejs v22.21.1明明下载到d盘的nvm目录下了,请给我介绍这些东西,然后告诉我应该怎么办现在

问题简介

①内容介绍

NVM_HOME

  • 作用 :指定nvm的安装目录
  • 你的配置 : D:\Program\Environment\nvm (正确,这是nvm实际安装的位置)
  • 说明 :这个目录下存放着nvm.exe可执行文件和所有已安装的Node.js版本

NVM_SYMLINK

  • 作用 :创建一个 符号链接目录 ,nvm通过这个目录来「切换」不同的Node.js版本
  • 你的配置 : C:\nvm4w\nodejs (这是nvm的默认符号链接目录)
  • 说明 :
    • 符号链接是一个「快捷方式」,指向当前正在使用的Node.js版本
    • 当你执行 nvm use 22.21.1 时,nvm会将 NVM_SYMLINK 目录指向 NVM_HOME\v22.21.1
    • 系统通过 Path 变量中的 %NVM_SYMLINK% 找到Node.js和npm命令

②问题分析

你的Node.js v22.21.1实际安装在 D:\Program\Environment\nvm\v22.21.1 目录下,但符号链接目录配置在 C:\nvm4w\nodejs 。这可能导致:

  • 符号链接创建失败(跨盘符号链接可能需要管理员权限)
  • 系统无法通过符号链接找到Node.js命令

③解决方法

步骤1:验证Node.js安装目录 首先确认你的Node.js版本确实存在:

  • 打开文件资源管理器,检查 D:\Program\Environment\nvm\v22.21.1 目录是否存在
  • 确认该目录下有 node.exe 和 npm.cmd 文件

步骤2:修改NVM_SYMLINK路径(推荐) 将符号链接目录修改为 与NVM_HOME同盘 的路径,避免跨盘问题:

  1. 右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 找到 NVM_SYMLINK 变量,修改为: D:\Program\Environment\Node.js(可以是任意不存在的目录名)
  3. 确认 Path 变量中包含 %NVM_SYMLINK%

步骤3:重新创建符号链接

  1. 以管理员身份打开命令行窗口 (重要!创建符号链接需要管理员权限)

  2. 执行以下命令:

    # 查看已安装的版本
    nvm list
    
    # 使用指定版本(会自动创建符号链接)
    nvm use 22.21.1

步骤4:验证环境 执行以下命令确认配置成功:

node -v
npm -v

总结这一小标题的问题:

nvm安装到d盘之后,也会下载node.js的版本Vxx.yy.zz到d盘中对应的nvm目录的下一级目录。但是在c盘的默认位置:c\nvm4w目录下,会创建一个nodejs快捷方式。导致可能出现跨盘问题,解决方法就是去环境变量中将NVM_SYMLINK的值改为d盘下某一个新的node.js目录

还有可能是powershell的权限设置,导致在trae中打不开 修改策略为RemoteSigned

PS C:\WINDOWS\system32> Get-ExecutionPolicy
Restricted
PS C:\WINDOWS\system32> Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

执行策略更改
执行策略可帮助你防止执行不信任的脚本。更改执行策略可能会产生安全风险,如 https:/go.microsoft.com/fwlink/?LinkID=135170
中的 about_Execution_Policies 帮助主题所述。是否要更改执行策略?
[Y] 是(Y)  [A] 全是(A)  [N] 否(N)  [L] 全否(L)  [S] 暂停(S)  [?] 帮助 (默认值为“N”): y
PS C:\WINDOWS\system32> Get-ExecutionPolicy
RemoteSigned

最简单的方法:

如果上述方法太复杂,最简单的是:

  1. 卸载当前 NVM 和 Node.js
  2. 清理所有环境变量
  3. 重新安装 NVM 到 D:\Program\Environment\nvm
  4. 安装时选择符号链接到 D:\Program\Environment\Node.js\nodejs

这样能保证从零开始,没有旧配置干扰。

建议

我建议你保留 D:\Program\Environment\nvm\v22.21.1 作为实际文件位置,使用 D:\Program\Environment\Node.js 作为符号链接。这样:

  1. 所有实际文件在 nvm 目录下
  2. Node.js 符号链接在一个单独的目录
  3. 方便管理多个 Node.js 版本

★最简单方法的流程截图★-重视安装

这一个小时内出现的问题,其实和安装过程有很大关系。。。

首选是安装nvm的地址,选择d盘下D:\Program\Environment

image-20251215210934047

然后是符号链接地址,选择d盘下D:\Program\Environment\Node.js

image-20251215211047088

接着一路next通过即可。。。这一个小时的坑其实总结下来,就是上面这两张图

基于 VitePress 搭建 | 记录生活与代码