以下是 Windows 10 安装和使用 npm 的详细步骤:
一、安装 Node.js(包含 npm)
1. 下载 Node.js
• 访问官网:https://nodejs.org/
• 下载 LTS 版本(长期支持版)
2. 安装步骤
a. 运行安装程序 (.msi)
b. 点击 "Next"
c. 接受许可协议
d. 选择安装路径(默认即可)
e. 在安装选项中,确保勾选:
✓ Node.js runtime
✓ npm package manager
✓ Add to PATH
f. 点击 "Install"
g. 完成安装
3. 验证安装
打开命令提示符(CMD)或 PowerShell,输入:
node -v
npm -v
如果显示版本号,说明安装成功。
二、npm 基本配置
1. 配置 npm
# 设置淘宝镜像(国内加速)
npm config set registry https://registry.npmmirror.com/
# 查看当前配置
npm config list
# 设置全局安装路径(避免C盘占用)
npm config set prefix "D:\DevelopTools\nodejs\npm_global"
npm config set cache "D:\DevelopTools\nodejs\npm_cache"
2. 设置环境变量
如果更改了全局安装路径,需要添加系统环境变量:
1. 右键"此电脑" → 属性 → 高级系统设置
2. 环境变量 → 系统变量 → Path → 编辑
3. 添加:D:\DevelopTools\nodejs\npm_global
三、npm 常用命令
1. 包管理命令
# 初始化项目(创建 package.json)
npm init
npm init -y # 快速初始化
# 安装包
npm install 包名 # 本地安装
npm install 包名 -g # 全局安装
npm install 包名 --save # 安装到 dependencies
npm install 包名 --save-dev # 安装到 devDependencies
# 安装项目依赖
npm install # 安装所有依赖
npm ci # 清洁安装(用于CI/CD)
# 卸载包
npm uninstall 包名
npm uninstall 包名 -g
# 更新包
npm update
npm update 包名
npm update -g
2. 项目操作
# 查看已安装的包
npm list
npm list -g --depth=0 # 查看全局安装的包
# 运行脚本
npm run 脚本名
# 查看包详情
npm view 包名
四、创建和运行 Node.js 项目
示例:创建 Express 项目
# 1. 创建项目目录
mkdir my-express-app
cd my-express-app
# 2. 初始化项目
npm init -y
# 3. 安装 Express
npm install express
# 4. 创建 index.js
# 添加以下代码:
const express = require('express');
const app = express();
app.get('/', (req, res) => {
res.send('Hello World!');
});
app.listen(3000, () => {
console.log('Server running on port 3000');
});
# 5. 在 package.json 中添加启动脚本
# 在 "scripts" 中添加:
# "start": "node index.js"
# 6. 运行项目
npm start
五、常见问题解决
1. 权限问题
# 使用管理员权限运行 CMD/PowerShell
# 或修改 npm 全局目录权限
2. 安装失败/网络问题
# 清除缓存
npm cache clean --force
# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com/
# 或使用 cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com
3. 版本管理
# 查看可升级的包
npm outdated
# 升级 npm 自身
npm install -g npm@latest
六、开发工具推荐
1. 编辑器:
• VS Code(推荐)
• WebStorm
2. 终端:
• Windows Terminal
• Git Bash
• PowerShell
3. 包管理器替代:
# yarn
npm install -g yarn
# pnpm
npm install -g pnpm
七、最佳实践建议
1. 项目结构:
project/
├── node_modules/ # 依赖包(.gitignore忽略)
├── src/ # 源代码
├── package.json # 项目配置
├── package-lock.json # 版本锁定
└── README.md # 说明文档
2. .gitignore 配置:
node_modules/
.env
*.log
3. 脚本示例:
{
"scripts": {
"start": "node index.js",
"dev": "nodemon index.js",
"test": "jest",
"build": "webpack"
}
}
按照以上步骤,你就能在 Windows 10 上顺利使用 npm 进行开发了。