一、为什么需要环境变量配置
在开发过程中，我们经常会遇到这样的情况：本地开发环境、测试环境和生产环境可能需要不同的依赖版本。比如，本地开发时可能用某个库的最新测试版，而生产环境则需要稳定版本。如果每次切换环境都要手动修改package.json，不仅麻烦，还容易出错。
这时候，Yarn 的环境变量配置就能派上用场了。它允许我们根据不同环境动态切换依赖版本，让项目配置更加灵活。
二、Yarn 环境变量的基本用法
Yarn 支持通过环境变量来控制依赖的安装和版本选择。最常用的方式是结合.yarnrc文件和scripts配置来实现。
示例 1：在 .yarnrc 中定义变量
# 技术栈：Node.js + Yarn
# .yarnrc 文件示例
env "development" {
react-version "18.2.0"
}
env "production" {
react-version "17.0.2"
}
这里，我们定义了两个环境变量react-version，分别对应开发和生产环境。
示例 2：在 package.json 中使用变量
{
"dependencies": {
"react": "$react-version"
},
"scripts": {
"start": "REACT_ENV=development yarn install",
"build": "REACT_ENV=production yarn install"
}
}
运行yarn start时，Yarn 会读取.yarnrc中的development配置，安装 React 18.2.0；而运行yarn build时，则会安装 React 17.0.2。
三、进阶用法：结合条件判断
有时候，我们可能需要更复杂的逻辑，比如根据操作系统或用户自定义变量来决定安装哪些依赖。这时候可以结合 Shell 脚本和 Yarn 的变量替换功能。
示例 3：动态选择依赖版本
{
"scripts": {
"setup": "if [ \"$NODE_ENV\" = \"production\" ]; then yarn install --production; else yarn install; fi"
}
}
这个脚本会根据NODE_ENV的值决定是否安装开发依赖。
四、实际应用场景
- 多环境部署：比如测试环境用 Beta 版本的库，生产环境用稳定版。
- A/B 测试：通过环境变量切换不同版本的依赖，测试新功能的影响。
- 团队协作：不同开发者可能偏好不同的工具链，可以通过环境变量灵活适配。
五、技术优缺点
优点
- 灵活性高：可以轻松适配不同环境的需求。
- 减少人为错误：避免手动修改
package.json导致的版本冲突。 - 可维护性强：环境配置集中管理，方便后续调整。
缺点
- 学习成本：新手可能需要时间熟悉 Yarn 的变量机制。
- 调试麻烦：如果变量配置错误，可能需要花时间排查。
六、注意事项
- 变量命名清晰：避免使用过于简单的变量名，比如
version，容易冲突。 - 测试环境一致性：确保本地、测试和生产环境的变量配置一致，避免出现“在我机器上能跑”的问题。
- 版本锁定：即使使用环境变量，也建议用
yarn.lock锁定依赖版本，避免意外升级。
七、总结
Yarn 的环境变量配置是一个强大的功能，特别适合需要多环境适配的项目。通过合理使用.yarnrc和scripts，我们可以让依赖管理更加智能，减少手动操作的麻烦。不过，也要注意变量命名的规范性和环境一致性，避免引入新的问题。
评论