前端工程化 / 知识点

pnpm / npm 包管理速查手册

环境与初始化

CODE
node --version; npm --version; pnpm --version

确认 Node.js、npm、pnpm 的版本、安装路径和当前生效配置。

查看版本与环境

用于确认当前终端实际调用的 Node.js、npm、pnpm,以及它们的可执行文件、仓库、缓存和全局目录。遇到“本机正常、CI 失败”“升级后版本没变化”或依赖从错误镜像下载时,先执行本条目。

macOS 与 Linux 一次性检查

bash
printf 'Node: '; node --version
printf 'npm:  '; npm --version
printf 'pnpm: '; pnpm --version

printf '\nNode executable: '; node -p "process.execPath"
printf 'npm executable:  '; command -v npm
printf 'pnpm executable: '; command -v pnpm

printf '\nnpm registry: '; npm config get registry
printf 'npm cache:    '; npm config get cache
printf 'npm prefix:   '; npm prefix -g
printf 'npm root:     '; npm root -g

printf '\npnpm registry: '; pnpm config get registry
printf 'pnpm store:    '; pnpm store path
printf 'pnpm global bin: '; pnpm bin -g

预期输出

text
Node: v<MAJOR>.<MINOR>.<PATCH>
npm:  <MAJOR>.<MINOR>.<PATCH>
pnpm: <MAJOR>.<MINOR>.<PATCH>

Node executable: <PATH>/node
npm executable:  <PATH>/npm
pnpm executable: <PATH>/pnpm

npm registry: https://registry.npmjs.org/
npm cache:    <PATH>/.npm
npm prefix:   <PATH>
npm root:     <PATH>/lib/node_modules

pnpm registry: https://registry.npmjs.org/
pnpm store:    <PATH>/pnpm/store/v<MAJOR>
pnpm global bin: <PATH>

版本号和路径会因操作系统、Node 版本管理器及安装方式不同而变化。重点检查三个版本是否符合项目要求,以及 node、npm、pnpm 是否来自同一套预期环境。

Windows PowerShell 检查路径

powershell
node --version
npm --version
pnpm --version
Get-Command node,npm,pnpm | Select-Object Name,Source
npm config get registry
npm config get cache
pnpm config get registry
pnpm store path
pnpm bin -g

预期输出

text
v<MAJOR>.<MINOR>.<PATCH>
<MAJOR>.<MINOR>.<PATCH>
<MAJOR>.<MINOR>.<PATCH>

Name     Source
----     ------
node.exe <PATH>\node.exe
npm.cmd  <PATH>\npm.cmd
pnpm.cmd <PATH>\pnpm.cmd
https://registry.npmjs.org/
<PATH>\npm-cache
https://registry.npmjs.org/
<PATH>\pnpm\store\v<MAJOR>
<PATH>\pnpm

Source 是当前命令解析到的实际文件。若同一命令存在多个副本,继续运行 Get-Command -All pnpm,优先处理排在最前面的旧路径。

输出读取

node -p "process.execPath" 显示 Node 可执行文件;npm prefix -g 是 npm 全局前缀,npm root -g 是全局包目录。pnpm store path 是内容寻址存储,pnpm bin -g 是全局命令目录。

需要查看配置来源时,使用 npm config get userconfig、npm config get globalconfig 和 pnpm config get globalconfig。npm 配置可能来自命令行、环境变量、项目 .npmrc、用户 .npmrc 和全局配置;pnpm 的仓库与认证仍可来自 .npmrc,其他新配置主要位于 pnpm-workspace.yaml 或全局 YAML 配置。

风险与排障

不要直接粘贴完整 .npmrc 到工单或聊天中,其中可能包含私有仓库令牌。安全替代方案是只读取 registry、cache、prefix 等非敏感键,并在分享前检查输出。

版本正确但命令路径异常,通常是 PATH 中残留了旧 Node、全局 pnpm 或 Corepack shim。先定位全部同名命令,再删除或调整确认无用的旧路径;不要直接清空系统目录。pnpm: command not found 时,先确认 Node 和 Corepack,再启用 Corepack 或重新安装 pnpm。

依赖安装

依赖维护

脚本与命令执行

信息与依赖追踪

锁文件与版本固定

目录与阅读设置

记录一个想法

pnpm / npm 包管理速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通