Node.js在Win10安装需选LTS版、自定义路径、勾选npm和PATH、重定向npm全局路径至非C盘、手动添加node_global到系统PATH,并配置淘宝镜像源。

如果您在Windows 10系统上尝试安装Node.js但遇到版本选择混乱、环境变量失效或全局模块路径占用C盘空间等问题,则很可能是安装路径、npm配置或系统PATH未正确设置所致。以下是针对Win10平台的完整安装与设置操作步骤:
一、下载并安装Node.js LTS版本
选择LTS(长期支持)版本可确保稳定性与兼容性,避免因使用Current版导致项目构建失败或依赖异常。该版本已内置npm,无需单独安装。
1、访问Node.js中文官网https://www.php.cn/link/3cbab37acac4fc1e6b3f78778d48c67d,确认页面显示“LTS”标签的最新稳定版(如v20.15.1或更高LTS编号)。
2、根据系统架构选择对应安装包:若为64位Win10,下载Windows Installer (.msi) 64-bit;若不确定,右键“此电脑”→“属性”,查看“系统类型”。
3、双击运行下载的.msi文件,勾选I accept the terms in the License Agreement,点击“Next”。
4、在安装路径页,点击“Change…”按钮,将默认C:\Program Files\nodejs\修改为非系统盘路径,例如D:\Develop\nodejs\,以规避重装系统时开发环境丢失风险。
5、在“Custom Setup”页,确保勾选npm package manager和Add to PATH两项,其余保持默认,连续点击“Next”直至完成安装。
二、验证基础安装是否成功
通过命令行检测Node.js与npm是否被系统识别,是后续所有配置的前提。若任一命令返回“不是内部或外部命令”,说明PATH未生效或安装异常。
1、按Win + R输入cmd,回车打开命令提示符。
2、输入node -v并回车,确认输出类似v20.15.1的版本号。
3、输入npm -v并回车,确认输出类似10.7.0的npm版本号。
4、若任一命令报错,请关闭所有命令行窗口,重新以管理员身份运行cmd,再执行上述验证。
三、重定向npm全局模块与缓存路径
默认情况下,npm全局安装(-g)的模块会写入C:\Users\{用户名}\AppData\Roaming\npm,持续占用系统盘空间且易受用户权限策略干扰。将其迁移至Node.js安装目录下可统一管理并规避权限问题。
用于端到端视频本地化流程的轻量编排器,路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...
1、在Node.js安装目录(如D:\Develop\nodejs\)中新建两个空文件夹:node_global和node_cache。
2、以管理员身份打开cmd,依次执行以下两条命令(注意路径需与实际一致,引号不可省略):
3、执行npm config set prefix "D:\Develop\nodejs\node_global"。
4、执行npm config set cache "D:\Develop\nodejs\node_cache"。
四、手动添加npm全局路径到系统环境变量
仅修改npm配置不足以使全局安装的命令(如npx、vue、create-react-app等)被系统识别,必须将node_global路径显式加入系统PATH变量,否则执行全局命令时将提示“不是内部或外部命令”。
1、右键“此电脑”→“属性”→“高级系统设置”→“环境变量”。
2、在“系统变量”区域,找到并选中“Path”,点击“编辑”。
3、点击“新建”,输入D:\Develop\nodejs\node_global(路径须与第三步中prefix设置完全一致)。
4、点击“确定”逐级保存所有更改。
五、配置淘宝npm镜像源加速国内依赖安装
默认npm官方源位于境外,国内用户常因网络延迟或连接失败导致install卡顿、超时或失败。切换为淘宝镜像(registry.npm.taobao.org)可显著提升模块下载成功率与速度。
1、在管理员权限cmd中执行:npm config set registry https://registry.npm.taobao.org。
2、验证配置是否生效:执行npm config get registry,输出应为https://registry.npm.taobao.org。
3、(可选)为全局安装命令同步镜像:执行npm install -g cnpm --registry=https://registry.npm.taobao.org,此后可用cnpm替代npm进行依赖安装。

















