1. 为什么我建议你在Windows上用Node.js写后端
先说结论:Windows完全能胜任Node.js后端开发,而且对于绝大多数中小型项目和业务系统来说,体验并不比macOS或Linux差太多。
我见过不少初学者被网上的言论吓住,总觉得“正经后端都得用Linux”,结果在Windows上畏手畏脚,甚至为了跑个Node.js先把系统换成了双系统。真没必要。Node.js本身就是跨平台的运行时,你在Windows上写的代码,部署到Linux服务器上照样能跑,唯一的差异集中在环境变量写法、文件路径分隔符、部分原生模块的编译这几个地方,后面我会逐个说。
那为什么选Node.js做后端?它最大的优势是“一门语言通吃前后端”。如果你已经会JavaScript,再去学后端逻辑,不需要切换语言心智,回调、Promise、异步流程这些概念在前端已经熟悉了,上手成本极低。就算你完全不会JavaScript,它的语法也足够直观,比起Java那一套类与接口的仪式感,Node.js更像是在“写逻辑”而不是“造架构”。
适合用Node.js做的后端场景也很明确:RESTful API服务、实时通信(WebSocket)、工具类中间服务、轻量级BFF层、物联网设备数据接入。它的短板在CPU密集型计算——比如图像处理、复杂算法这类场景,Node.js的单线程模型会吃大亏,这时候你该选Python或Go,而不是硬用Node.js扛。
再说Windows作为开发环境,有几个被低估的优点:PowerShell和Windows Terminal现在很好用,WSL(Windows Subsystem for Linux)随时可以切一套Linux环境跑命令,Docker Desktop在Windows上跑Linux容器也早已成熟。也就是说,你完全可以“在Windows上开发,在容器里运行”,两边的好处都占上。这篇文章的所有操作,我都基于纯Windows环境(不带WSL),这样门槛最低,也最贴合大多数新手实际面临的情况。
我会从安装Node.js这个最容易被忽视的第一步讲起,然后带着你完整地初始化一个项目、写一个能跑起来的HTTP服务、接上热重载和调试工具,最后把Windows上常见的坑和排查方法整理出来。整个过程会在Windows 11 + Node.js 20 LTS环境下演示,你不需要有任何后端基础,只需要会打开命令行就够了。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备:安装Node.js的正确姿势与版本管理
2.1 选择LTS版本还是Current版本
打开Node.js官网,你会看到两个下载按钮:一个是LTS(长期支持版),一个是Current(当前最新版)。很多新手会下意识点那个写着“最新”的按钮,但这其实是个坑。
LTS版本是给生产环境用的,官方承诺长期维护,API稳定,生态里的第三方包兼容性最好。Current版本虽然有着最新的特性,但也意味着它刚上线不久,很多npm包还没来得及跟上,你在安装依赖时可能会遇到莫名其妙的编译报错。尤其是那些带原生C++模块的包(比如bcrypt、sharp),在Current版本上经常出幺蛾子。
我给你的建议非常直接:开发环境用LTS,想尝鲜新特性就另开一个目录用Current版本单独折腾。 不要在主项目里挑战最新版。
2.2 一步步完成安装
安装包没什么特别的,去官网下载Windows Installer(.msi)就行。需要注意的点集中在安装向导里:
- 安装路径建议保持默认(
C:\Program Files\nodejs\),或者改成D:\nodejs\也完全可以,避免路径中出现中文和空格。 - 向导里有个“Add to PATH”选项,默认是勾选的,一定要保持勾选。这一步会把Node.js的可执行文件路径写入系统环境变量,之后你才能在任何目录下直接使用
node命令。 - 向导里还有个选项是安装“Node.js runtime”和“npm package manager”,全部保持默认勾选。
- 如果向导询问是否安装“Tools for Native Modules”,也就是编译原生模块所需的Visual Studio Build Tools,我建议先跳过。等你真的遇到需要编译的包时再装也不迟,这时候装只会白白消耗时间和磁盘空间。
安装完成后,打开一个新的终端窗口(这一步很关键,旧窗口不会刷新环境变量),输入以下命令验证:
bash复制node -v
能输出类似v20.16.0的版本号,说明安装成功。接着验证npm:
bash复制npm -v
2.3 用nvm-windows管理多版本Node.js
如果你只是短暂地写个Demo,直接装一个LTS版本就够了。但如果你打算长期做Node.js开发,我强烈建议你现在把官方安装包卸了,换成nvm-windows来管理Node.js版本。
原因是现实工作中你几乎一定会遇到“这个老项目要用Node 14,那个新项目要用Node 20”的情况。没有版本管理工具,你就得反复卸载安装,光是环境变量出错就够你折腾一晚上。nvm-windows就是干这个的,它允许你在同一台机器上装多个Node.js版本,并随时切换。
安装步骤:
- 先去GitHub上搜
coreybutler/nvm-windows,下载最新版的nvm-setup.exe。 - 安装过程中有一步让你选择“Symlink”路径,这个路径是用来存放当前激活的Node.js版本的。默认是
C:\Program Files\nodejs,保持默认就行。 - 安装完成后打开新的终端,运行
nvm version验证是否安装成功。
常用命令就四个:
bash复制# 查看已安装的版本
nvm list
# 安装指定版本
nvm install 20.16.0
# 切换版本
nvm use 20.16.0
# 查看远程所有可用版本
nvm list available
切换到某个版本后,你再执行node -v就会看到对应版本号。npm会跟着Node.js版本自动切换,不需要额外操作。
提示:nvm-windows切换版本的本质是修改symlink的指向,所以不用手动改环境变量。如果你之前用官方安装包装过Node.js,建议先彻底卸载干净再装nvm-windows,否则可能出现两个Node.js抢PATH的情况,到时候
node -v输出的版本会忽上忽下,非常迷惑。
2.4 配置npm镜像源
npm默认从官方源下载包,在国内网络环境下速度可能不太理想。我建议一开始就配置成国内镜像源,省得后面每次装包都卡在那等很久。
bash复制# 查看当前源
npm config get registry
# 配置为淘宝镜像源
npm config set registry https://registry.npmmirror.com
关于镜像源,有个细节值得知道:registry.npmmirror.com是阿里云维护的npm官方镜像,同步频率很高,稳定性经过了多年考验。如果你在公司内网,还可以配置成公司私有的npm源,操作方式完全一样。
换完源之后,安装依赖包的速度会有一个质的提升。
3. 项目初始化:从npm init到package.json的深度理解
3.1 创建项目目录
环境搞定之后,找一个合适的位置创建项目目录。我个人习惯在D:\projects\下建一个文件夹,专门放代码项目,不给C盘添负担。
bash复制# 进入你打算放项目的目录,比如D盘
cd D:\projects
# 创建项目目录并进入
mkdir node-demo
cd node-demo
