安装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
