How to migrate a project from npm to pnpm

迁移项目从npm到pnpm是一个可以提高包管理效率和节省磁盘空间的好方法。下面是一个详细的步骤指南：

1. 安装pnpm

首先，你需要在你的机器上安装pnpm。可以通过以下命令安装：

bash
npm install -g pnpm

2. 准备迁移

在迁移之前，应该确保当前项目在npm下是处于工作状态的，这包括运行测试和确保所有依赖都是最新的。这样可以比较迁移前后的行为，确保迁移没有引入问题。

3. 删除node_modules和package-lock.json

pnpm使用不同的方式来安装和链接依赖，所以需要删除现有的node_modules文件夹以及package-lock.json或npm-shrinkwrap.json文件（如果存在的话）：

bash
rm -rf node_modules package-lock.json

4. 使用pnpm安装依赖

现在你可以使用pnpm来安装你的项目依赖了。在你的项目根目录下运行：

bash
pnpm install

这将会安装所有在package.json中声明的依赖，并创建一个pnpm-lock.yaml文件，类似npm的package-lock.json，但是是为了pnpm定制的。

5. 测试项目

安装完成后，运行项目的测试和构建脚本，确保一切工作如预期。你可以运行：

bash
pnpm run test
pnpm run build
# 或者其他相应的脚本

如果遇到任何与依赖相关的问题，检查并更新package.json中的依赖声明，并确保它们与pnpm-lock.yaml匹配。

6. 更新CI/CD脚本

如果你的项目使用了持续集成/持续部署(CI/CD)，确保更新相关脚本以使用pnpm命令替代npm命令。

例如，你可能需要更新.travis.yml、Jenkinsfile、GitLab-CI.yml等配置文件。

7. 提交更改

提交这些更改到版本控制系统：

bash
git add pnpm-lock.yaml
git commit -m "Migrate from npm to pnpm"

确保不要提交node_modules文件夹，通常这个文件夹应该在.gitignore中排除。

8. 通知团队成员

如果你是在团队中工作，确保通知所有成员他们需要切换到pnpm。你可以提供pnpm安装步骤和迁移后可能遇到的常见问题。

9. 监控生产环境

如果迁移后的项目将要部署到生产环境，密切监控应用程序以确保没有因为迁移而引起的问题。如果有问题，根据日志和指标迅速定位问题源头并修复。

以上是将项目从npm迁移到pnpm的一个基本指南。实际过程可能会根据项目的具体情况（如依赖的复杂性，自动化脚本的使用等）而有所不同。

Finally, I have made a backup of node_modules and rebuilt it from scratch with pnpm and added concat to have only one JavaScript source and applied Google-compiler to it.

The only difficulty was about bootstrap because it has changed a lot in two years. We need to keep the old look of it, so the command I used is pnpm install bootstrap@3.3.7.

After completion, the look and feel was identical but node_modules has grew from 8 MB to 12 MB...

You can pnpm import which takes your package-lock.json or yarn.lock and generates pnpm's lock file pnpm-lock.yaml. After that, you can pnpm install to install the dependencies of the project.

documentation