项目级 .npmrc 配置说明

.npmrc 是 npm（Node Package Manager）的配置文件，用于自定义 npm 行为，例如镜像源、认证信息、代理和缓存路径等。

作用

• 配置 npm 默认行为（如镜像源、代理、缓存路径）。
• 存储私有仓库认证信息（如企业内部 npm token）。
• 覆盖 npm 默认配置（如 engine-strict、save-exact）。
• 提升依赖安装过程的可控性与稳定性。

常见配置项

配置项	说明	示例
_authToken	私有仓库 token（通常按域名配置）	//registry.npmjs.org/:_authToken=your-token
strict-ssl	是否严格校验 SSL 证书（默认 true）	strict-ssl=false
prefix	全局安装路径	prefix=/path/to/global/node_modules
proxy	HTTP 代理地址	proxy=http://127.0.0.1:8080
https-proxy	HTTPS 代理地址	https-proxy=http://127.0.0.1:8080
cache	npm 缓存目录	cache=/path/to/cache
registry	npm 仓库地址（镜像源）	registry=https://registry.npmmirror.com
engine-strict	强制检查 Node.js 与 npm 版本	engine-strict=true
save-exact	安装依赖时固定版本（不使用 ^ / ~）	save-exact=true

存放位置

级别	存放路径	作用范围
项目级	项目根目录下的 .npmrc	仅当前项目生效
用户级	~/.npmrc（Linux/macOS）或 C:\Users\<username>\.npmrc（Windows）	当前用户的所有项目
全局级	Node 安装目录下的 npmrc（可通过 npm config get globalconfig 查看）	当前环境的全局配置