如何在 package.json 中指定所需的 Node.js 版本？

Question

我有一个需要 Node 12 或更高版本的 Node.js 项目。有没有办法在packages.json文件中指定，这样安装程序会自动检查并通知用户是否需要升级？

Answer 1

您可以在package.json 中设置engines 字段，并为node 或npm 版本或两者设置要求：

  "engines" : { 
    "npm" : ">=7.0.0",
    "node" : ">=16.0.0"
  }

要通过 npm 强制执行此操作，您需要创建一个 .npmrc 文件（并将其提交到存储库）并将 engines-strict 选项设置为 true，这将导致诸如 npm install 之类的 npm 命令失败，如果所需的引擎版本不匹配：

# .npmrc
engine-strict=true

如果没有该文件，每个开发人员都需要在其本地工作区中运行 npm config set engine-strict true 才能启用此选项。

原答案

正如您所说，您的代码绝对不能与任何较低版本一起使用，您可能也需要“engineStrict”标志：

{ "engineStrict" : true }

package.json 文件的文档可以在on the npmjs site找到

更新

engineStrict 现在已弃用，因此只会发出警告。现在由用户来运行npm config set engine-strict true，如果他们想要的话。

更新 2

正如下面所指出的，如果 Node 版本不是，在项目的根目录（与 package.json 文件相同的级别）创建一个带有文本 engine-strict=true 的 .npmrc 文件将在安装期间强制出错兼容。

Answer 2

就像 Ibam 所说，engineStrict 现在已被弃用。但我找到了这个解决方案：

check-version.js：

import semver from 'semver';
import { engines } from './package';

const version = engines.node;
if (!semver.satisfies(process.version, version)) {
  console.log(`Required node version ${version} not satisfied with current version ${process.version}.`);
  process.exit(1);
}

package.json：

{
  "name": "my package",
  "engines": {
    "node": ">=50.9" // intentionally so big version number
  },
  "scripts": {
    "requirements-check": "babel-node check-version.js",
    "postinstall": "npm run requirements-check"
  }
}

在此处了解更多信息： https://medium.com/@adambisek/how-to-check-minimum-required-node-js-version-4a78a8855a0f#.3oslqmig4

.nvmrc

还有一件事。 点文件 '.nvmrc' 可用于要求特定节点版本 - https://github.com/creationix/nvm#nvmrc

但是，它只受到 npm 脚本（和 yarn 脚本）的尊重。

Answer 3

还有另一种更简单的方法：

1. npm install Node@8（将节点 8 保存为 package.json 中的依赖项）
2. 您的应用将使用 Node 8 运行，适用于任何人 - 甚至是 Yarn 用户！

这是有效的，因为node 只是一个将 node 作为其包二进制文件的包。它只包含作为 node_module/.bin ，这意味着它只使 node 可用于打包脚本。不是主外壳。

在此处查看 Twitter 上的讨论：https://twitter.com/housecor/status/962347301456015360

Answer 4

将以下内容添加到package.json：

  "engines": {
    "npm": ">=6.0.0",
    "node": ">=10.0.0"
  },

将以下内容添加到.npmrc（与package.json相同的目录）：

engine-strict=true

Answer 5

.nvmrc

如果您是 using NVM like this，您可能应该这样做，那么您可以在 git 跟踪的 .nvmrc 文件中指出给定项目所需的 nodejs 版本：

node --version > .nvmrc

或：

echo v10.15.1 > .nvmrc

这不会在cd 上自动生效，这是正常的：用户必须执行以下操作：

nvm use

现在该版本的节点将用于当前 shell。

您可以列出您拥有的节点版本：

nvm list

.nvmrc 记录在：https://github.com/creationix/nvm/tree/02997b0753f66c9790c6016ed022ed2072c22603#nvmrc

在cd 上询问如何自动选择该节点版本：Automatically switch to correct version of Node based on project

.nvmrc 与 package.json engines

你可能想做的是：

• 使用engines in package.json 给出“没有已知的不兼容范围
• 给.nvmrc 设置一个“已测试”

很像 package.json 与 package-lock.json。

使用 NVM 0.33.11 测试。

Heroku 确实尊重 package.json engines:

值得一提的是，作为documented here，Heroku 确实玩得很好，并遵守engines: 条目，例如：

  "engines": {
    "node": "14.17.0",
    "npm": "6.14.13"
  },

所以你应该 Always, Always 将它设置为你在本地使用的。

这个self deleted answer to this thread之前已经提到过。

Answer 6

Mocha 测试用例示例：

describe('Check version of node', function () {
    it('Should test version assert', async function () {

            var version = process.version;
            var check = parseFloat(version.substr(1,version.length)) > 12.0;
            console.log("version: "+version);
            console.log("check: " +check);         
            assert.equal(check, true);
    });});