离线安装 pnpm：给内网 Windows 电脑装上“万能工具箱”

离线安装 pnpm给内网 Windows 电脑装上“万能工具箱”没有互联网也能优雅地用上 pnpm—— 一篇写给小白的保姆级离线安装教程你是否有过这样的经历公司的开发机在纯内网不能连外网但你想跑一个现代前端项目比如 Next.js、Vite或者酷炫的 OpenClaw而项目文档里写着大大的几个字pnpm install。没有 pnpm寸步难行。别慌这篇文章就是为你准备的。我会用最通俗的语言 最准确的步骤告诉你如何在外网把 pnpm 打包成“离线工具箱”然后搬到内网 Windows 电脑上顺利安装。一、先搞明白pnpm 是什么为什么要离线装pnpm是一个比 npm 更快、更省磁盘空间的包管理器。很多现代项目比如 OpenClaw都选择它来管理依赖。离线安装 pnpm 听起来像是个死循环要装 pnpm通常需要联网执行npm install -g pnpm但内网没有网怎么装解决思路很简单在外网把 pnpm 下载成一个离线包.tgz 文件然后搬到内网像搬运一箱工具一样再拆包安装。二、准备工作Node.js 是地基在安装 pnpm 之前内网 Windows 电脑必须先有 Node.js。因为 pnpm 本质上是一个 Node.js 写的工具需要 Node.js 环境来运行。如何离线安装 Node.js在外网下载安装包打开 Node.js 官网选择Windows 64-bit的LTS 版本比如node-v22.14.0-x64.msi。LTS Long Term Support稳定可靠适合大多数项目。搬到内网用 U 盘或共享文件夹把.msi文件复制到内网 Windows 电脑。安装双击.msi一路 Next。关键一步确保勾选 “Add to PATH” —— 这样你才能在命令行里直接用node和npm命令。验证打开命令提示符cmd输入node -v npm -v如果看到版本号说明 Node.js 安装成功。 小贴士如果你需要管理多个 Node 版本可以在外网顺便下载nvm-windows的安装包搬运进来安装。但对于大多数项目一个 LTS 版本就足够了。三、核心步骤在外网打包 pnpm现在你需要在可以联网的电脑Windows / Mac / Linux 都行上把 pnpm 打包成一个离线包。1. 确认 npm 可用外网电脑必须已经安装了 Node.js通常都有。打开终端输入npm -v确认。2. 执行打包命令npmpackpnpm这个命令会从 npm 官方仓库下载 pnpm 的最新版本并打包成一个.tgz文件例如pnpm-9.0.0.tgz。npm pack就像把 pnpm 这个“工具箱”压缩成一个行李箱。生成的.tgz文件就是一个完整的离线安装包不依赖网络就可以安装。3. 找到这个文件命令执行完后在当前目录下就会生成pnpm-9.0.0.tgz版本号可能不同。把它复制到 U 盘里。四、内网安装拆箱 使用带着你的 U 盘回到内网 Windows 电脑。1. 把.tgz文件放到一个方便的位置例如D:\offline-packages\pnpm-9.0.0.tgz。2. 打开命令提示符cmd按Win R输入cmd回车。3. 执行全局安装命令npm install -g D:\offline-packages\pnpm-9.0.0.tgz-g表示全局安装这样你可以在任何目录下使用pnpm命令。路径请替换成你电脑上.tgz文件的实际路径。4. 等待安装完成npm 会解压这个 .tgz 文件并把 pnpm 的可执行文件放到 Node.js 的安装目录下。整个过程很快而且完全不依赖网络。5. 验证安装输入pnpm -v如果看到版本号比如9.0.0恭喜你pnpm 已经成功在内网电脑上安家落户了。五、常见问题 避坑指南问题现象可能原因解决方法pnpm 不是内部或外部命令环境变量未刷新关闭 cmd 重新打开或者重启电脑npm install -g报错ENOENT.tgz文件路径错误使用绝对路径或者先cd到.tgz所在目录然后执行npm install -g ./pnpm-xxx.tgz安装后pnpm -v显示旧版本之前安装过其他版本的 pnpm先卸载旧版本npm uninstall -g pnpm再重新安装想指定特定版本而不是最新版外网打包时指定版本npm pack pnpm8.15.0即可打包指定版本六、扩展不只是 pnpm任何 npm 包都可以这样离线安装这个方法不仅适用于 pnpm也适用于任何你想离线安装的 npm 全局工具比如http-server、nodemon、vercel等等。万能公式在外网npm pack 包名得到.tgz搬到内网npm install -g 路径/包名.tgz你可以为团队准备一个“离线工具包”里面放着所有常用的.tgz文件新同事入职时一键安装省去联网配置的烦恼。七、接下来安装项目依赖现在 pnpm 已经装好了你可以继续按照项目的文档执行pnpm install。但注意如果整个项目依赖也需要离线安装因为内网没有 npm 仓库你需要使用pnpm-airgap或私有仓库方案。那是另一篇教程的内容但至少现在pnpm 这个核心工具已经在手了。写在最后离线环境并不可怕它只是把“即时下载”变成了“提前准备”。npm pack就像一个神奇的行李箱让你能把任何 npm 工具装进去带到没有网络的角落。希望这篇教程能帮你顺利跨过离线安装 pnpm 这道坎。如果你在操作中遇到任何问题欢迎在评论区留言我会尽力帮你解决。Happy offline coding!—— 你的离线开发好伙伴