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,先安装目标主版本并切换,再检查当前命令解析到的版本。
nvm install 24
nvm use 24
node --version
npm --version预期输出(关键行)
Now using node v24.<VALUE>.<VALUE>
v24.<VALUE>.<VALUE>
<VALUE>.<VALUE>.<VALUE>补丁版本和 npm 版本会随 Node.js 发行版变化,因此用 <VALUE> 表示动态值。Windows 团队可以使用统一选定的跨平台版本管理器,但仍应遵守同一个原则:仓库声明版本,开发机和 CI 按声明安装。
安装 pnpm 并验证
Node.js 可用后,用 npm 安装团队约定的 pnpm 版本,并立即检查可执行文件和全局存储目录。若公司内部有镜像或软件分发策略,应替换为团队批准的安装来源。
npm install --global pnpm@10.15.1 --silent
pnpm --version
pnpm store path预期输出(关键行)
10.15.1
<PATH>pnpm 的存储路径会因操作系统与本机配置不同,因此用 <PATH> 表示动态值。关键验收点是 pnpm --version 返回团队规定的版本,并且存储目录可以正常解析。
把版本约束写进仓库
仅靠文档约定不够,还应让仓库本身表达运行时和包管理器要求。下面是 package.json 的片段示例,假设团队固定到 pnpm 10.15.1。
{
"packageManager": "pnpm@10.15.1",
"engines": {
"node": ">=24 <25"
}
}这是配置片段,不会自行安装工具。packageManager 记录项目期望的 pnpm 版本,engines.node 声明 Node.js 兼容范围;版本变更仍应通过代码评审,并同步更新开发环境和 CI。
如果团队使用 nvm,还可以在仓库根目录增加 .nvmrc,内容只保留主版本:
24这也是配置片段。验证方法是在仓库目录执行 nvm use,再检查版本。
nvm use
node --version
pnpm --version预期输出(关键行)
Now using node v24.<VALUE>.<VALUE>
v24.<VALUE>.<VALUE>
10.15.1用项目安装验收环境
工具命令可用只是第一层检查。进入已经提交 package.json 与 pnpm-lock.yaml 的项目后,应使用锁文件执行严格安装;CI 也应采用相同模式,避免依赖版本被悄悄改写。
pnpm install --frozen-lockfile --reporter=silent
printf 'environment ok\n'预期输出
environment ok如果 --frozen-lockfile 报告锁文件与 package.json 不一致,应先由开发者更新并评审锁文件,而不是在 CI 中关闭严格检查。当开发机、仓库约束和 CI 使用同一 Node.js 主版本与 pnpm 版本策略时,环境搭建才算真正完成。