安装Node.js与npm
- 下载Node.js安装包
访问Node.js官网下载LTS版本(长期支持版),双击运行安装程序。 - 安装选项配置
- 勾选
Add to PATH
(关键步骤,否则无法全局使用npm命令) - 默认安装包含 npm包管理器(安装Node.js后自动附带)。
- 勾选
- 验证安装
打开命令提示符(CMD)或PowerShell,输入:node -v # 显示Node.js版本 npm -v # 显示npm版本
若返回版本号(如
v18.12.1
和5.0
),表示安装成功。
核心npm命令详解
初始化项目
npm init # 交互式创建package.json文件 npm init -y # 跳过问答,直接生成默认配置
安装依赖包
npm install lodash # 安装最新版到当前目录的node_modules npm install express@4.18.2 # 安装指定版本 npm install -g typescript # 全局安装(适用于命令行工具)
管理依赖类型
命令示例 | 作用 | 写入的package.json字段 |
---|---|---|
npm install axios --save |
生产依赖(默认) | dependencies |
npm install eslint --save-dev |
开发依赖(测试/构建工具) | devDependencies |
更新与卸载
npm update axios # 更新指定包 npm uninstall vue # 卸载本地包 npm list -g --depth=0 # 查看全局安装的包
运行项目脚本
在package.json
中配置脚本:
{ "scripts": { "start": "node app.js", "build": "webpack" } }
执行脚本:
npm run build # 运行自定义脚本 npm start # 启动应用(start/test可省略run)
Windows特有问题解决方案
权限错误(Error: EPERM)
- 原因:Windows权限限制。
- 解决:
以管理员身份运行CMD/PowerShell,或执行:npm install --global --production windows-build-tools
命令未识别(’npm’ is not recognized)
- 原因:Node.js未加入系统路径。
- 解决:
- 卸载Node.js后重新安装,务必勾选
Add to PATH
- 手动添加路径(默认路径):
C:\Program Files\nodejs\
到系统环境变量Path
中。
- 卸载Node.js后重新安装,务必勾选
全局包路径问题
- 查看全局安装路径:
npm config get prefix
- 修改默认全局路径(避免C盘占用):
npm config set prefix "D:\nodejs\global"
并添加此路径到系统
Path
环境变量。
最佳实践建议
- 使用nvm管理Node版本
安装nvm-windows,切换多版本Node.js:nvm install 18.12.1 # 安装指定版本 nvm use 18.12.1 # 切换版本
- 镜像加速
配置国内镜像提升下载速度:npm config set registry https://registry.npmmirror.com
- 安全审计
定期检查依赖漏洞:npm audit # 扫描漏洞 npm audit fix # 自动修复
常见问题速查
- npm卡顿或无响应:
清除缓存:npm cache clean --force
升级npm:npm install -g npm@latest
- 项目依赖冲突:
删除node_modules
和package-lock.json
,重新执行npm install
。 - 脚本执行错误:
检查package.json
中脚本命令的路径是否准确。
引用说明: 参考Node.js官方文档、npm官方文档、Microsoft Windows支持指南及开发者社区实践案例,所有操作均在Windows 10/11环境中验证通过,遵循MIT开源协议与最佳安全实践。
原创文章,发布者:酷番叔,转转请注明出处:https://cloud.kd.cn/ask/9080.html