Wireit环境变量管理终极指南：外部变量与默认值设置技巧

想要让你的npm脚本更智能、更高效？Wireit的环境变量管理功能正是你需要的终极解决方案！Wireit通过强大的环境变量配置系统，让你的构建过程更加可控和灵活。🚀

为什么需要Wireit环境变量管理？

在现代化的前端开发中，环境变量管理是构建工具链不可或缺的一环。Wireit提供了两种主要的环境变量配置方式：

🔧 直接设置环境变量

使用env配置项可以直接为脚本设置环境变量值，这些值会覆盖父进程中的同名变量。这种方式在macOS/Linux和Windows上都能一致工作，无需担心不同shell的兼容性问题。

环境变量配置示例：

{
  "wireit": {
    "my-script": {
      "command": "my-command",
      "env": {
        "MY_VARIABLE": "my value"
      }
    }
  }
}

🌐 外部环境变量声明

当你的脚本行为受到外部设置的环境变量影响时，需要使用external: true来声明：

{
  "wireit": {
    "my-script": {
      "command": "my-command",
      "env": {
        "MY_VARIABLE": {
          "external": true
        },
        "MY_VARIABLE_2": {
          "external": true,
          "default": "foo"
      }
    }
  }
}

核心环境变量详解

Wireit提供了多个内置环境变量来控制其行为：

📊 WIREIT_PARALLEL - 并行控制

默认情况下，Wireit会为每个逻辑CPU核心运行最多2个并行脚本。你可以通过设置这个变量来调整并行度：

export WIREIT_PARALLEL=1
npm run build

💾 WIREIT_CACHE - 缓存策略

控制Wireit的缓存行为，支持local、github和none三种模式。

🎯 WIREIT_FAILURES - 失败处理

定义当脚本失败时的处理方式，包括no-new、continue和kill三种模式。

默认值设置技巧

为外部环境变量设置默认值是一个非常有用的技巧。当外部没有提供该变量值时，Wireit会自动使用你设置的默认值。

最佳实践建议

1. 明确区分变量来源：直接设置的变量用于脚本执行环境，外部声明的变量用于指纹计算。

2. 合理设置默认值：为重要的外部变量设置合理的默认值，避免因缺少配置而导致的构建失败。

3. 考虑CI环境：在CI环境中，Wireit会自动禁用本地缓存，确保构建的纯净性。

4. 环境变量与缓存：记住，环境变量的变化会影响脚本的指纹，进而影响缓存命中率。

通过掌握Wireit的环境变量管理，你可以构建出更加智能、高效的开发工作流。无论是本地开发还是CI/CD环境，都能获得最佳的性能表现！✨