使用 engines 限制开发环境依赖

在前端项目开发中，由于 Node.js 和包管理工具的版本差异，经常会出现"在我的机器上能运行"的问题。为了解决这个问题，我们可以使用 package.json 中的engines字段来限制开发环境。

engines 配置详解

在 package.json 文件中，可以添加以下配置：

"engines": {
  "node": "18.15.0",
  "pnpm": "8.15.4"
}

这个配置清晰地表明项目需要使用：

Node.js 版本为 18.15.0
pnpm 版本为 8.15.4

engines 配置的作用

添加 engines 配置后，会产生以下效果：

明确开发环境要求：向所有开发者说明项目所需的准确环境版本
版本检查：常见的包管理工具（npm、yarn、pnpm 等）会检查这个配置，当版本不匹配时发出警告或报错
自动化部署支持：在支持 engines 配置的部署平台（如 Heroku 等）上，会自动使用指定的版本

更多 engines 配置选项

除了 Node.js 和 pnpm，您还可以根据项目需要限制其他工具的版本，例如：

"engines": {
  "node": "18.15.0",
  "npm": "9.5.0",
  "yarn": "1.22.19",
  "pnpm": "8.15.4"
}

扩充 .npmrc 文件

难免有些开发人员使用 npm 安装依赖，所以需要扩充 .npmrc 文件

engine-strict=true

.npmrc 中 engine-strict=true 开启时：
- npm 安装｜发布｜更新依赖（npm install）会严格检查 package.json 中的 engines 要求
- npm 运行脚本（npm run dev）不受影响，可以正常运行
.npmrc 中 engine-strict=true 注销时：
- npm 安装｜发布｜更新依赖时会读取 package.json 中的 engines 配置，但只作为警告，不会阻止安装
- npm 运行脚本正常工作

如何切换到指定 Node.js 版本

如果您的 Node.js 版本与项目要求不符，可以使用 nvm(Node Version Manager)来安装和切换到指定版本：

# 安装指定版本
nvm install 18.15.0

# 切换到指定版本
nvm use 18.15.0

总结

在项目中使用 engines 配置是一种工程化实践，可以确保所有开发者在统一的环境下工作，避免因环境差异导致的各种问题。这是解决"在我的电脑上能运行"问题的有效方法，特别适合团队协作开发的项目。