Merge branch 'cl-corepack'

.vitepress/config.ts

@@ -41,7 +41,8 @@ export default defineConfig({
               { text: '箭头函数-括号', link: 'arrow-function-bracket' },
               { text: '使用 VitePress + GitHub Pages 搭建网站', link: 'github-deploy' },
               { text: '必要的最佳实践', link: 'best-practice' },
-              { text: '第三季度技术分享', link: 'share-quarter-3' }
+              { text: '第三季度技术分享', link: 'share-quarter-3' },
+              { text: 'corepack', link: 'corepack' }
             ]
           }
         ]

src/frontend/corepack.md

@@ -0,0 +1,58 @@
+# corepack
+Node 版本管理使用 nvm 等，如果想要管理包管理器 pnpm 的版本，可以尝试使用 corepack，在团队中统一包管理器的版本也很重要，简单介绍一下 corepack 的使用指南，仅供参考
+
+## 快速上手
+1. 启用 corepack，默认是禁用的，需要手动启用
+
+```bash
+corepack enable
+```
+
+2. 打开一个 node 项目，项目需指定包管理器的版本
+
+```json
+{
+  "packageManager": "[email protected]"
+}
+```
+
+3. 在项目文件目录下直接执行如下命令即可，若电脑上没有安装指定的 pnpm 版本，corepack 会为你安装此项目指定的版本
+
+```bash
+pnpm install
+```
+
+![pnpm-install-sucess](/pnpm-install-sucess.png)
+
+::: info 注意事项
+- 安装完 corepack 后在桌面目录下第一次执行 pnpm 命令，corepack 会为你安装一个全局的 pnpm 版本，当项目没有指定的包管理器时，会使用此版本的包管理器
+
+- corepack 会自动检测项目里是否有指定的包管理器，如果没有，使用全局版本，如果有，使用指定的版本，如果电脑上没有此版本，会在你执行pnpm 命令时帮你下载此版本
+:::
+
+## 遇到的问题
+目前只遇到一个网络问题
+
+### 报错截图
+![pnpm-install-error](/pnpm-install-error.png)
+
+### 出现原因
+国内网络访问不了默认npm镜像（https://registry.npmjs.org），即使开启科学上网也是访问不了（暂时不知道为什么）
+
+### 解决办法
+使用阿里的 npm 镜像（https://registry.npmmirror.com），如果仅仅在 `.npmrc` 中设置了阿里镜像，没有效果，corepack 仍然使用的是默认镜像，需要额外设置 `COREPACK_NPM_REGISTRY` 的值
+
+- Windows
+
+```bash
+# powershell
+setx COREPACK_NPM_REGISTRY https://registry.npmmirror.com
+```
+
+- Mac
+
+在 `.zshrc` 或 `.bashrc` 末尾添加 `export COREPACK_NPM_REGISTRY=$(npm config get registry)`
+
+::: info 注意
+我没有Mac，没有试过，此方法是在 GitHub 上寻找的
+:::