npm 命令入门指南（前端小白版）

1. npm 是什么？

Node Package Manager：Node.js 的包管理工具，用于安装、分享 JavaScript 工具/库。
核心功能 ：
- ✅ 安装第三方库（如 React、Vue）
- ✅ 管理项目依赖
- ✅ 发布自己的插件

2. 最常用命令

命令	作用	示例
`npm init`	创建 `package.json`（项目说明书）	`npm init -y`（快速创建）
`npm install`	安装依赖包	`npm install lodash`
`npm run`	运行自定义脚本	`npm run dev`
`npm update`	更新依赖包	`npm update react`
`npm publish`	发布自己的包	`npm publish`

3. npm 仓库类型

仓库类型	说明	地址
官方仓库	默认公共库（全球最大）	npmjs.com
镜像仓库	国内加速镜像（推荐）	淘宝镜像 `registry.npmmirror.com`
私有仓库	企业内部专用	Verdaccio / Nexus

4. 如何更换仓库？

(1) 临时切换镜像（单次生效）

bash 复制代码

npm install lodash --registry=https://registry.npmmirror.com

(2) 永久切换镜像

bash 复制代码

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

(3) 恢复官方仓库

bash 复制代码

npm config set registry https://registry.npmjs.org

(4) 验证当前仓库

bash 复制代码

npm config get registry

5. 提交插件到 npm 仓库

步骤 1：注册 npm 账号

👉 访问 npmjs.com/signup

步骤 2：登录 npm

bash 复制代码

npm login  # 输入用户名/密码/邮箱

步骤 3：初始化插件项目

bash 复制代码

mkdir my-plugin && cd my-plugin
npm init -y  # 生成 package.json

步骤 4：编写代码

js 复制代码

// index.js
module.exports = () => console.log("Hello Plugin!");

步骤 5：发布！

bash 复制代码

npm publish  # 自动上传到 npm 仓库

注意：

包名在 package.json 的 "name" 中定义（需全网唯一）

更新版本：npm version patch + npm publish

常见问题

安装卡住？ → 换淘宝镜像 npm config set registry https://registry.npmmirror.com
发布失败？ → 检查包名是否重复或未登录
插件汉化？ → 在 package.json 添加中文描述字段

小白学习路径

用 npm install 装几个库（如 axios）
尝试创建 package.json
发布一个测试插件（名字加后缀如 my-plugin-test123）

官方文档：npm Docs

中文资源：npm 淘宝镜像

📌 npm 全局安装位置、缓存位置及查看方法（完整指南）

🔍 1. 全局安装位置

📂 默认路径

操作系统	全局安装路径
Windows	`%AppData%\npm\node_modules`
macOS/Linux	`/usr/local/lib/node_modules` 或 `/usr/lib/node_modules`

🔎 如何查看当前全局安装路径？

bash 复制代码

npm root -g

输出示例（Windows）：

复制代码

C:\Users\你的用户名\AppData\Roaming\npm\node_modules

🔎 如何查看全局安装的包？

bash 复制代码

npm list -g --depth=0

输出示例：

复制代码

/usr/local/lib
├── npm@10.2.3
├── nrm@1.2.5
└── yarn@1.22.19

🔍 2. 全局可执行文件位置

全局安装的包的可执行文件（如 create-react-app）会被链接到以下目录：

操作系统	可执行文件路径
Windows	`%AppData%\npm`
macOS/Linux	`/usr/local/bin`

🔎 如何查看全局可执行文件路径？

bash 复制代码

which npm          # macOS/Linux
where npm          # Windows

🔍 3. npm 缓存位置

npm 下载的包会缓存到以下目录：

操作系统	缓存路径
Windows	`%AppData%\npm-cache`
macOS/Linux	`~/.npm`

🔎 如何查看当前缓存路径？

bash 复制代码

npm config get cache

输出示例：

复制代码

C:\Users\你的用户名\AppData\Roaming\npm-cache

🔎 如何查看缓存内容？

bash 复制代码

npm cache ls

输出示例（部分）：

复制代码

~/.npm/_cacache/content-v2/sha512/xx/xx/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

🔍 4. 实用命令汇总

需求	命令
查看全局安装路径	`npm root -g`
查看全局安装的包	`npm list -g --depth=0`
查看全局可执行文件路径	`which <命令>` (Linux/macOS) / `where <命令>` (Windows)
查看缓存路径	`npm config get cache`
查看缓存内容	`npm cache ls`
清理缓存	`npm cache clean --force`
卸载全局包	`npm uninstall -g <包名>`

🚨 常见问题排查

权限问题（macOS/Linux）

如果全局安装失败，可能是权限不足，尝试：
bash 复制代码
```
sudo chown -R $(whoami) /usr/local/lib/node_modules
```
或使用 npx 临时运行（无需全局安装）。
缓存占用过大

定期清理缓存：
bash 复制代码
```
npm cache clean --force
```
路径冲突

如果 npm root -g 和 which npm 路径不一致，可能是环境变量 NODE_PATH 配置错误，检查：
bash 复制代码
```
echo $NODE_PATH
```

🎯 总结

全局安装路径 ：npm root -g
可执行文件路径 ：which <命令> 或 where <命令>
缓存路径 ：npm config get cache
缓存清理 ：npm cache clean --force

掌握这些命令后，你可以轻松管理 npm 的全局包和缓存，避免磁盘空间浪费和路径冲突问题！