Vue / 系统课时

安装 Node.js 与包管理器

安装 Node.js 与包管理器

团队环境搭建的目标不是“本机能运行”,而是所有开发者和 CI 都能得到兼容的 Node.js 与 pnpm。这里以 Node.js 24 主版本和 pnpm 10.15.1 为示例,用版本管理器切换 Node.js,并在项目中显式记录版本约束。

学习目标

  • 能使用版本管理器安装并切换团队约定的 Node.js 主版本
  • 能安装 pnpm 并验证 Node.js、npm 与 pnpm 命令可用
  • 能在仓库中记录 Node.js 与 pnpm 版本约束,减少环境漂移

先确定团队版本策略

企业项目应优先选团队统一验证过的 Node.js LTS 主版本,而不是每个人自行追随 Current 版本。主版本升级要作为一次显式工程变更处理:升级本地环境、CI 镜像和依赖后重新执行完整检查,再合入主分支。

本课用 Node.js 24 与 pnpm 10.15.1 演示。实际项目如果已经规定其他受支持版本,应以仓库和 CI 的约定为准,不要为了跟随示例而私自修改。

安装并切换 Node.js

在 macOS 或 Linux 上,如果团队使用 nvm,先安装目标主版本并切换,再检查当前命令解析到的版本。

bash
nvm install 24
nvm use 24
node --version
npm --version

预期输出(关键行)

text
Now using node v24.<VALUE>.<VALUE>
v24.<VALUE>.<VALUE>
<VALUE>.<VALUE>.<VALUE>

补丁版本和 npm 版本会随 Node.js 发行版变化,因此用 <VALUE> 表示动态值。Windows 团队可以使用统一选定的跨平台版本管理器,但仍应遵守同一个原则:仓库声明版本,开发机和 CI 按声明安装。

安装 pnpm 并验证

Node.js 可用后,用 npm 安装团队约定的 pnpm 版本,并立即检查可执行文件和全局存储目录。若公司内部有镜像或软件分发策略,应替换为团队批准的安装来源。

bash
npm install --global pnpm@10.15.1 --silent
pnpm --version
pnpm store path

预期输出(关键行)

text
10.15.1
<PATH>

pnpm 的存储路径会因操作系统与本机配置不同,因此用 <PATH> 表示动态值。关键验收点是 pnpm --version 返回团队规定的版本,并且存储目录可以正常解析。

把版本约束写进仓库

仅靠文档约定不够,还应让仓库本身表达运行时和包管理器要求。下面是 package.json 的片段示例,假设团队固定到 pnpm 10.15.1。

json
{
  "packageManager": "pnpm@10.15.1",
  "engines": {
    "node": ">=24 <25"
  }
}

这是配置片段,不会自行安装工具。packageManager 记录项目期望的 pnpm 版本,engines.node 声明 Node.js 兼容范围;版本变更仍应通过代码评审,并同步更新开发环境和 CI。

如果团队使用 nvm,还可以在仓库根目录增加 .nvmrc,内容只保留主版本:

text
24

这也是配置片段。验证方法是在仓库目录执行 nvm use,再检查版本。

bash
nvm use
node --version
pnpm --version

预期输出(关键行)

text
Now using node v24.<VALUE>.<VALUE>
v24.<VALUE>.<VALUE>
10.15.1

用项目安装验收环境

工具命令可用只是第一层检查。进入已经提交 package.json 与 pnpm-lock.yaml 的项目后,应使用锁文件执行严格安装;CI 也应采用相同模式,避免依赖版本被悄悄改写。

bash
pnpm install --frozen-lockfile --reporter=silent
printf 'environment ok\n'

预期输出

text
environment ok

如果 --frozen-lockfile 报告锁文件与 package.json 不一致,应先由开发者更新并评审锁文件,而不是在 CI 中关闭严格检查。当开发机、仓库约束和 CI 使用同一 Node.js 主版本与 pnpm 版本策略时,环境搭建才算真正完成。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Node.js 与包管理器

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

登录哪都通