Composable Storefront 的开发模式，不能用 npm install

Composable Storefront 2211，如果强行用 npm install 安装，过程倒是很快，但是装完后，TypeScript 版本号是错的：

node_modules 下的 TypeScript 文件夹是空的：

那为什么 Spartacus Github repository 里有个 package-lock.json 文件？

在深入讨论 yarn install 命令及其与 package-lock.json 文件的关系之前，我们首先需要明确几个关键概念：Yarn、npm、package-lock.json 以及 yarn.lock。这些概念对于理解 yarn install 命令的行为模式至关重要。通过本文，我们将逐步解析 Yarn 如何处理依赖关系，特别是在执行 yarn install 时，它如何与项目中存在的不同配置文件互动。

1. Yarn 和 npm 的基本介绍

Yarn 和 npm 都是 JavaScript 生态中广泛使用的包管理工具，它们帮助开发者安装、更新以及管理项目依赖。虽然这两个工具的目标相同，但它们在实现细节上存在差异。Yarn 在 2016 年由 Facebook 发布，主要是为了解决当时 npm 在性能、安全性以及一致性方面的一些问题。Yarn 引入了 yarn.lock 文件，以确保项目依赖的一致安装。

npm 是 Node.js 的默认包管理工具，随 Node.js 一同安装。npm 使用 package-lock.json 文件来锁定依赖的版本，确保开发、测试和生产环境的一致性。

2. package-lock.json 和 yarn.lock

package-lock.json 是 npm 用来记录当前状态下实际安装的依赖树的精确版本的文件。这样可以确保团队成员或部署环境中的每个人都使用相同的依赖版本，从而避免“在我机器上运行正常”问题。

相对地，Yarn 使用 yarn.lock 文件来达到类似的目的。当你使用 Yarn 安装依赖时，它会根据 yarn.lock 中记录的版本信息来安装依赖，如果 yarn.lock 不存在，Yarn 会根据 package.json 中声明的版本范围生成一个新的 yarn.lock 文件。

3. yarn install 与 package-lock.json

来到我们的核心问题，当执行 yarn install 命令时，Yarn 实际上不会查找或使用 package-lock.json 文件。Yarn 的设计哲学和工作流与 npm 有所不同，它依赖自己的 yarn.lock 文件来确保依赖的版本一致性。如果你的项目中同时包含 package-lock.json 和 yarn.lock 文件，这通常意味着项目成员在使用不同的包管理工具，这可能会引起混乱和不一致的问题。

举个例子，假设你的项目中有一个 package-lock.json 文件，这个文件是由 npm 在之前的操作中生成的。此时，如果你切换到 Yarn 并执行 yarn install，Yarn 不会查看 package-lock.json 文件，而是会根据 package.json 中的依赖声明生成（或更新）yarn.lock 文件。这意味着即使 package-lock.json 在项目中存在，它也不会影响 Yarn 管理依赖的方式。

4. 最佳实践

鉴于 Yarn 和 npm 在处理依赖锁定文件上的差异，遵循一些最佳实践可以帮助维护项目的一致性和可维护性：

• 统一团队使用的包管理工具：为了避免 package-lock.json 和 yarn.lock 文件之间的不一致，团队成员应该统一使用 Yarn 或 npm 作为项目的包管理工具。
• 不要同时提交 package-lock.json 和 yarn.lock 到版本控制：选择你的团队决定使用的包管理工具对应的锁文件，只将其提交到版本控制系统。这可以减少混淆并确保依赖的一致性。
• 在项目文档中明确指定：在 README 文件或项目文档中指出项目使用的包管理工具，以及新成员应如何安装依赖，可以进一步减少团队内的混淆。

5. 结论

在处理 JavaScript 项目依赖时，了解不同包管理工具的工作原理及其文件系统是至关重要的。虽然 yarn install 不会直接检索或使用 package-lock.json 文件，但理解这一行为背后的原理对于确保项目依赖的稳定性和一致性非常重要。通过采取一致的包管理策略和遵循最佳实践，团队可以避免很多常见的问题，确保项目的顺利进行。