我遵循了Heroku上Node.js的基本入门说明:

https://devcenter.heroku.com/categories/nodejs

这些指令并没有告诉你创建一个.gitignore node_modules,因此意味着node_modules文件夹应该签入Git。当我在Git存储库中包含node_modules时,我的启动应用程序正常运行。

当我遵循更高级的例子在:

用Node.js, Ruby, MongoDB和Socket构建实时,多语言应用程序。IO https://github.com/mongolab/tractorpush-server(源)

它指示我将文件夹node_modules添加到文件.gitignore中。因此,我从Git中删除了node_modules文件夹,将其添加到.gitignore文件中,然后重新部署。这次部署失败了,如下所示:

-----> Heroku receiving push
-----> Node.js app detected
-----> Resolving engine versions
       Using Node.js version: 0.8.2
       Using npm version: 1.0.106
-----> Fetching Node.js binaries
-----> Vendoring node into slug
-----> Installing dependencies with npm
       Error: npm doesn't work with node v0.8.2
       Required: node@0.4 || 0.5 || 0.6
           at /tmp/node-npm-5iGk/bin/npm-cli.js:57:23
           at Object.<anonymous> (/tmp/node-npm-5iGk/bin/npm-cli.js:77:3)
           at Module._compile (module.js:449:26)
           at Object.Module._extensions..js (module.js:467:10)
           at Module.load (module.js:356:32)
           at Function.Module._load (module.js:312:12)
           at Module.require (module.js:362:17)
           at require (module.js:378:17)
           at Object.<anonymous> (/tmp/node-npm-5iGk/cli.js:2:1)
           at Module._compile (module.js:449:26)
       Error: npm doesn't work with node v0.8.2
       Required: node@0.4 || 0.5 || 0.6
           at /tmp/node-npm-5iGk/bin/npm-cli.js:57:23
           at Object.<anonymous> (/tmp/node-npm-5iGk/bin/npm-cli.js:77:3)
           at Module._compile (module.js:449:26)
           at Object.Module._extensions..js (module.js:467:10)
           at Module.load (module.js:356:32)
           at Function.Module._load (module.js:312:12)
           at Module.require (module.js:362:17)
           at require (module.js:378:17)
           at Object.<anonymous> (/tmp/node-npm-5iGk/cli.js:2:1)
           at Module._compile (module.js:449:26)
       Dependencies installed
-----> Discovering process types
       Procfile declares types -> mongod, redis, web
-----> Compiled slug size is 5.0MB
-----> Launching... done, v9

运行“heroku ps”确认了崩溃。好的,没有问题,所以我回滚了更改,将文件夹node_module添加回Git存储库,并从文件.gitignore中删除它。但是,即使在恢复之后,我仍然在部署时得到相同的错误消息,但现在应用程序再次正确运行了。运行“heroku ps”告诉我应用程序正在运行。

正确的做法是什么?是否包含文件夹node_modules ?为什么回滚时仍然会得到错误消息?我猜Heroku这边的Git仓库状态很差。


当前回答

我正在使用这个解决方案:

Create a separate repository that holds folder node_modules. If you have native modules that should be build for specific platform then create a separate repository for each platform. Attach these repositories to your project repository with git submodule: git submodule add .../your_project_node_modules_windows.git node_modules_windows git submodule add .../your_project_node_modules_linux_x86_64 node_modules_linux_x86_64 Create a link from platform-specific node_modules to node_modules directory and add node_modules to .gitignore. Run npm install. Commit submodule repository changes. Commit your project repository changes.

因此,您可以轻松地在不同平台上的node_modules之间切换(例如,如果您在OS X上开发并部署到Linux上)。

其他回答

在Heroku上创建Node.js应用程序时,我应该在文件夹“node_modules”中检入Git吗?

但是Stack Overflow的格式很奇怪。

如果您没有相同的机器,并且正在检入node_modules,请在本机扩展上执行.gitignore。我们的。gitignore看起来像:

# Ignore native extensions in the node_modules folder (things changed by npm rebuild)
node_modules/**/*.node
node_modules/**/*.o
node_modules/**/*.a
node_modules/**/*.mk
node_modules/**/*.gypi
node_modules/**/*.target
node_modules/**/.deps/
node_modules/**/build/Makefile
node_modules/**/**/build/Makefile

通过首先检入所有内容来测试,然后让另一个开发人员执行以下操作:

rm -rf node_modules
git checkout -- node_modules
npm rebuild
git status

确保没有文件更改。

如果你正在为你的应用程序滚动你自己的模块,你可以:

保留这些(仅保留这些)在应用程序的/node_modules文件夹中,并将所有其他依赖项移出到parent ../ node_modules文件夹。这将工作,因为NodeJS CommonJS模块系统的工作方式是向上移动到父目录,等等,直到到达树的根。参见:https://nodejs.org/api/modules.html 或者gitignore除/node_modules/your-modules之外的所有/node_modules/*。参见:使.gitignore忽略除少数文件外的所有内容

这个用例非常棒。它让你可以很好地保留你专门为应用程序创建的模块,并且不会因为以后可以安装的依赖关系而变得混乱。

从Git中的"node_modules":

回顾一下。 仅为您部署的应用程序签入node_modules,不可重用 您维护的包。 任何编译的依赖项都应该有它们的依赖项 源签入,而不是编译目标,并且应该$ NPM重新构建 在部署。

我最喜欢的部分:

所有将node_modules添加到gitignore的人,都删除它 妈的,今天,这是一个我们都很乐意离开的时代的产物 在后面。全局模块的时代已经结束了。

(最初的链接是这个,但现在已经死了。谢谢@Flavio指出这一点

第二次更新

常见问题解答不再可用。

从收缩膜的文件:

如果您希望锁定包中包含的特定字节,例如有100%的信心能够重新生成部署或构建,那么您应该检查源代码控制中的依赖项,或者使用其他可以验证内容而不是版本的机制。

香农和史蒂文之前提到过这个问题,但我认为这应该是公认答案的一部分。


更新

以下建议所列的来源已经更新。他们不再建议提交node_modules文件夹。

通常,没有。允许npm为你的包解析依赖关系。 对于你部署的包,比如网站和应用程序,你应该使用npm 收缩包装锁定您的全部依赖树: https://docs.npmjs.com/cli/shrinkwrap


最初的发布

作为参考,npm FAQ清楚地回答了你的问题:

将你部署的东西(比如网站)的node_modules签入git 和应用程序。不检查node_modules到git的库和模块 打算被重用。使用npm来管理开发中的依赖项 环境,但不在部署脚本中。

想要找到一些合理的理由,可以阅读Mikeal Rogers的帖子。


来源:https://docs.npmjs.com/misc/faq should-i-check-my-node-modules-folder-into-git

场景1:

一个场景:

你使用一个从npm中移除的包。如果所有模块都在node_modules文件夹中,那么这对您来说就不是问题。如果在包中只有包名。Json,你不能再得到它了。

如果一个包的使用时间小于24小时,可以很容易地从npm中删除它。 如果超过24小时,那么你需要联系他们。

But:

如果您联系技术支持,他们将检查删除该版本的软件包是否会破坏任何其他安装。如果是,我们将不删除它。

阅读更多

所以出现这种情况的几率很低,但有第二种情况……


场景2:

另一种情况是这样的:

你开发了一个企业版本的软件或者一个非常重要的软件,在你的package.json中写道:

"dependencies": {
    "studpid-package": "~1.0.1"
}

使用该包的方法function1(x)。

现在studpid-package的开发人员将方法function1(x)重命名为function2(x),他们犯了一个错误… 它们将包的版本从1.0.1更改为1.1.0。 这是一个问题,因为当你下次调用npm install时,你将接受1.1.0版本,因为你使用了波浪号("studpid-package": "~1.0.1")。

现在调用函数1(x)可能会导致错误和问题。


将整个node_modules文件夹(通常超过100 MB)推到存储库中会占用内存空间。 几个kb(包。json仅)相比,数百MB(包。Json & node_modules)…想想看。

你可以这样做/应该考虑如果:

软件非常重要。 当某件事失败了,你就得花钱。 你不相信NPM注册表。NPM是中心化的,理论上可以被关闭。

在99.9%的情况下,你不需要发布node_modules文件夹,如果:

你为自己开发了一个软件。 你编程了一些东西,只是想在GitHub上发布结果,因为其他人可能会对它感兴趣。


如果您不希望node_modules在存储库中,只需创建一个.gitignore文件并添加node_modules行。