GoPick

请在浏览器里打开

微信里打不开这个页面

  1. 1复制下面这个网址
  2. 2粘贴到浏览器打开

也可以在右上角 ··· 里选「在浏览器中打开」

Node.js 下载安装:npm install 卡半天不动?换个源就快了

Node.js 是让 JavaScript 能在浏览器外面跑起来的运行环境,免费开源。装它的实际用途通常是两件事:跑前端项目的构建工具,用 npm 装各种命令行工具。Windows 上装它就是一个 msi 的事,装完 node -v 能出版本号就算成了。

下载地址
链接来自网盘,打开后直接保存到自己的网盘即可

一、Node.js 下载安装教程:它是干什么的#

JavaScript 这门语言原本只在浏览器里活着。Node.js 把 Chrome 的 V8 引擎单独拎出来做成了一个可执行程序,于是 .js 文件能像 Python 脚本一样在命令行里直接跑,也能起一个 Web 服务监听端口。

对普通用户来说,装 Node.js 的理由基本不是「我要写 JavaScript」,而是这些东西需要它:

你要装的东西为什么需要 Node
Claude Code、Gemini CLI 这类命令行 AI 工具它们本身就是 npm 包
Vite、Webpack、Next.js 等前端脚手架构建过程跑在 Node 上
Hexo、VuePress 等静态博客生成器同上,生成 HTML 靠 Node
Sass、TypeScript 编译器都是 npm 生态里的包
各种 MCP 服务器通过 npx 拉起

所以大概率的情况是:你装某个工具,教程第一行写着「先安装 Node.js 18 以上」,你就来了。

Node 和 npm 的关系:npm 是包管理器,跟着 Node 一起装,不用单独下。装好 Node 就有 npm。

要不要装? 上面表格里没有你想装的东西,那就别装。它占的空间不大,但会往 PATH 里塞东西,用不上纯属多余。

二、下载#

NODE-1
NODE-1

三、安装步骤#

这个包不用安装,解压两层,配一下 PATH 就能跑。

  1. 解压外层 Node.js【JavaScript运行环境】.zip,里面是 node-v24.22.0-win-x64.zip,
  2. 把内层 zip 解压到一个固定目录,比如 D:\Tools\nodejs。解完的文件夹里 node.exe、npm.cmd 都在最上层:
NODE-2
NODE-2
  1. 免安装版没有安装程序替你登记路径,PATH 必须手动加:右键「此电脑」→「属性」→「高级系统设置」→「环境变量」,在用户变量的 Path 里「新建」,把 D:\Tools\nodejs 粘进去,连点三个「确定」。
  2. 配完 PATH 必须重开命令行窗口(老窗口读不到新环境变量)。

验证装好了#

新开一个命令行窗口(重要——已经开着的窗口读不到新加的环境变量),输入:

node -v
npm -v

分别输出 node 和 npm 各自的版本号就对了。实测输出(node 24.22.0、npm 11.15.1):

NODE-3
NODE-3

配一下镜像源#

npm 官方源在国内速度不稳定,装大一点的包容易卡在 sill fetch 上。换成国内镜像:

npm config set registry https://registry.npmmirror.com

(npmmirror.com 是原来的淘宝镜像,现在独立运营。)

改完用 npm config get registry 确认。想换回来就把它设成 https://registry.npmjs.org。

注意:换镜像只影响下载速度,不改包的内容。但有少数包在镜像上更新滞后,装到旧版本的话临时切回官方源试一下。

四、费用与授权#

Node.js 是 MIT 协议的开源项目,由 OpenJS Foundation 托管,全部功能免费,没有商业版和社区版之分。

没有激活码、没有许可证文件、不联网校验、不限制商用。OpenJS Foundation 的钱来自企业赞助,不走卖 license 这条路,这一点从 2009 年项目诞生到现在没变过。

npm 本身也是免费开源的。它背后的 npm 公司被 GitHub 收购后并入了微软,公共仓库的下载服务一直免费。

唯一跟钱有关的是私有包托管——把包发布成只有团队能装的那种,npm 官方提供付费方案。个人开发用不到。

五、第一次用:跑一个文件,装一个包#

跑一个 js 文件#

新建一个文本文件,改名 test.js,内容写:

console.log("hello", process.version);
console.log(process.platform);

在这个文件所在的目录打开命令行(地址栏输入 cmd 回车最快),执行:

node test.js

输出两行:第一行是 hello 加版本号,第二行是 win32。到这一步说明运行环境和 PATH 都通了。

装第一个包#

npm install -g cowsay

-g 是全局安装,装完这个命令在任何目录都能用。装完执行 cowsay 你好,屏幕上会出现一头牛把这句话说出来。

全局安装的包放在 C:\Users\你的用户名\AppData\Roaming\npm,这个路径会在安装 Node 时自动加进 PATH。

不安装直接跑#

npx cowsay 你好

npx 是 npm 自带的命令,它会把包临时下载到缓存里执行,不污染全局环境。很多工具的「一键使用」都是这么实现的,比如 npx create-vite。

第一次执行 npx 会问你要不要安装,输入 y 回车。

六、装完能干的几件事#

起一个本地前端项目。 npm create vite@latest 项目名,一路回车,然后 cd 项目名 再 npm install、npm run dev,浏览器打开提示的本地地址就能看到页面。这是现在最主流的前端起步方式。

装命令行 AI 工具。 这类工具在 npm 上都能找到,装法基本是 npm install -g 包名,装完直接敲命令名。注意它们对 Node 版本有要求,装之前看一眼文档,版本太低会直接报错退出。

跑别人给的项目。 拿到一个带 package.json 的文件夹,进去执行 npm install 装依赖,再 npm run dev 或 npm start 起服务。这一步是整个前端生态里最高频的操作。

编译 TypeScript。 npm install -g typescript 之后有 tsc 命令,能把 .ts 编成 .js。

管理全局工具清单。 npm list -g --depth=0 列出装过哪些全局包,npm uninstall -g 包名 卸掉。装多了会忘,隔段时间清一次。

切换 Node 版本。 需要同时用 18 和 26 的话,装一个版本管理工具比反复卸载重装省事得多——Windows 上常用的是 nvm-windows。

七、几个会踩的坑#

「'node' 不是内部或外部命令。」

两种原因。一是安装时没勾「Add to PATH」,重新运行安装包选「Change」补上;二是装完了但命令行窗口没重开,环境变量是进程启动时读取的,老窗口读不到,关掉重开。

还有一种情况:PATH 里 Node 的路径排在一个同名命令后面。用 where node 能看到所有匹配项,检查是不是有别的程序也叫 node。

「npm install 卡住不动,或者报 ETIMEDOUT。」

先换镜像源(见上文)。换完还卡,检查有没有配代理:npm config get proxy,返回不是 null 说明配了代理而代理不通,用 npm config delete proxy 清掉。公司网络需要走代理的话,把代理地址配上,别留空。

「装包时报错,一堆 gyp、MSBuild、Python 的字样。」

这个包带 C++ 原生代码,要现场编译。两个解决办法:一是装 Visual Studio Build Tools(勾「使用 C++ 的桌面开发」);二是换用不依赖编译的替代包,比如 node-sass 换成 sass(纯 JS 实现,装完即用)。

「npm 报 EACCES 或者 EPERM 权限错误。」

Windows 上常见于全局安装。不要用管理员身份开命令行硬装,那会把文件权限搞乱。正确做法是把 npm 全局目录改到用户目录下:

npm config set prefix "C:\Users\你的用户名\AppData\Roaming\npm"

改完重开命令行。

「项目跑起来提示 engine 不匹配。」

package.json 里写了 "engines": {"node": ">=20"} 这类要求,你的版本低于它。升 Node,或者用 npm install --engine-strict=false 绕过——绕过不一定能跑,只是不提前拦你。

「装了两个 Node,node -v 显示的还是旧版本。」

PATH 里顺序问题。用 where node 看全部匹配路径,把想要的往前排,或者干脆卸掉多余的。装了 nvm-windows 的话,不要再用 msi 装第二个 Node,两套东西会互相覆盖 PATH。

「C 盘越来越小。」

npm 的缓存目录默认在 C:\Users\你的用户名\AppData\Local\npm-cache,装过一堆包之后能到几个 G。用 npm cache clean --force 清,或者 npm config set cache 改到别的盘。清理缓存不会影响已装好的包,下次装同名包会重新下载。

装完先试着 npm config set registry 换个国内源,后面装包会快很多。