src和dist文件夹在NPM包中的角色

Question

我使用Restangular进行HTTP请求。 我想使用方法customPATCH。 我可以在Restangular src /目录看到它在这里 。

但是，当我运行'npm install restangular'并指向dist /文件夹时，我收到错误“customPATCH不是函数”。 我注意到dist /文件夹中的源代码与src /文件夹中的源代码不同 （它没有定义customPATCH方法）。

为什么在src /和NPM包中的dist /之间存在什么差异？ 这些通常保持同步吗？ 在这种情况下，dist /目录在8个月内未更新。 我应该只使用src /文件夹中的源代码吗？ 也许我误解了如何使用NPM包（我总是使用dist /文件夹中的源代码）...

Answer 1

src/和dist/是大多数软件包的通用命名约定。 在大多数情况下，开发人员拥有他们正在处理src/的代码以及他们希望其他人使用dist/的代码的分发版本。 大多数开发人员，我的自我包括将编译，缩小或连接他们的代码到面向生产的代码版本。 它们通常在其公共存储库中包含src/文件，以便人们可以查看源代码并在其认为合适时对其进行修改。

TDLR;

src/是开发人员正在使用的代码。

dist/是已修改的分发版本，以便为不希望修改代码工作方式的用户执行更好的操作。

Answer 2

通常， src包含缩小后的源代码和dist代码以及其他更改（无论如何，派生代码 - Java世界中的target是什么）。

有时当主repo用EcmaScript6或更新版本编写时， dist文件夹包含编译到EcmaScript5的代码，以支持旧版本的nodejs /旧浏览器。

你可以使用src代码（如果它适合你） - 但是通常dist代码会缩小并因此更快。

但有时作者忘记更新dist文件夹，然后你可能会有差异。 您可以ping作者重建dist文件夹。