在微服务架构或复杂的开发环境中，我们经常需要在本地开发、测试环境和生产环境之间频繁切换。手动修改代码中的 BASE_URL 既低效又容易出错。本文将带你深入了解如何利用环境变量优雅地解决 API 自动配置问题，并探讨在特定场景下如何绕过系统代理以提升调试效率。

环境变量为我们提供了一种解耦方式，使得应用程序的行为可以根据运行环境而改变，而无需修改源代码

关于解耦：

指降低系统各组件之间的依赖程度，使它们可以独立变化、独立部署、独立测试。

Windows 环境变量确实是解耦的一种体现，但它属于一种更具体的模式——配置与代码分离，也叫外部化配置

它解耦了什么？

环境变量把”程序需要某个值”和“这个值从哪来、是什么”这两件事分开了。

程序只写：

import os
db_url = os.environ["DB_URL"] # 只按名字拿，不管值从哪里来

至于 DB_URL 到底是本地数据库、测试库还是生产库——程序完全不知道，也不需要知道。换环境时改一个变量，程序代码零修改

本质上，环境变量名（比如 JAVA_HOME）扮演的角色就像一个接口——它是程序和”真实路径”之间的契约。程序依赖的是这个名字，而不是具体路径。所以说，环境变量是接口解耦思想在”配置层”的一种应用，只不过接口不是代码里的 abstract class，而是操作系统提供的键值表。

实现 API 自动切换的核心逻辑

大多数现代框架使用 .env 文件来管理环境变量。

Windows 系统环境变量
↓ 同一思想，更轻量的实现
.env 文件
↓ 读取 .env 并注入到进程环境
python-dotenv / dotenv.js 等库
↓ 约定俗成后形成标准
12-Factor App 方法论（Factor III: Config）

.env 本质上就是一个”私有的、项目级的环境变量表”。它解决了 Windows/Linux 系统环境变量的一个痛点：系统变量是全局的，不同项目容易冲突，而且不方便版本管理。

使用 python-dotenv 库，我们可以轻松实现：

import os
from dotenv import load_dotenv

# 加载当前目录下的 .env 文件
load_dotenv()

class APIClient:
    def __init__(self):
        # 默认指向生产环境，除非环境变量指定了开发环境
        self.base_url = os.getenv("API_BASE_URL", "https://api.production.com")
        self.timeout = int(os.getenv("API_TIMEOUT", 10))

    def get_data(self, endpoint):
        url = f"{self.base_url}/{endpoint}"
        print(f"Connecting to: {url}")
        # 执行请求...

这样，不同环境只需要维护各自的 .env 文件（比如 .env.dev、.env.prod），代码本身完全不用动。

特定场景：为什么有时候还要绕过代理

上面的方案解决了”连哪个环境”的问题，但还有一类问题它管不着：网络怎么走。

这个问题在国内的开发场景里其实很常见。比如你的电脑上开着梯子（VPN/代理），平时用来访问一些被墙的技术文档、GitHub、Stack Overflow。但一旦你需要连校园网内网服务，或者要开腾讯会议参加评审、周会，代理就成了绊脚石——内网地址走代理出去，等于绕了一圈找不到路，直接连不上；腾讯会议这类国内实时音视频服务，走了代理更是直接卡死或者干脆连接失败。

于是你不得不：手动断开梯子 → 开会/连内网 → 开完再手动打开梯子 → 继续调试国外依赖。每次都要切换，麻烦，还容易忘。

这本质上和前面讲的是同一个问题：环境变量解决的是”连哪个地址”，而这里要解决的是”走不走代理”——但思路完全一致，都是把易变的东西外部化，而不是写死在代码或手动操作里。

用 NO_PROXY 环境变量按需排除

大多数支持代理的库（requests、curl、甚至系统级网络栈）都遵循一套约定俗成的环境变量：

• HTTP_PROXY / HTTPS_PROXY：指定代理地址
• NO_PROXY：指定哪些域名或 IP 不走代理，直连

比如你可以这样配置：

bash

export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export NO_PROXY="localhost,127.0.0.1,*.tencent.com,10.0.0.0/8,192.168.0.0/16"

这样一来，访问 *.tencent.com（腾讯会议相关域名）或者内网地址段时会自动直连，不经过代理；而访问其他地址依然走代理翻墙。不用再手动开关梯子了——梯子始终开着，只是特定流量被”豁免”了。

代码层面显式绕过

如果你在写 Python 脚本调试某个内网 API，光靠系统级 NO_PROXY 有时候不够（比如某些库会忽略系统代理设置，或者你只想临时对这一次请求生效），可以在代码里直接强制绕过：

python

import requests

# 强制这次请求不走任何代理，无论系统/环境变量怎么配置
response = requests.get(
    "http://internal-api.campus.edu/data",
    proxies={"http": None, "https": None}
)

结合前面的 APIClient，可以扩展成这样，让”是否走代理”也变成一个可配置项：

python

import os
from dotenv import load_dotenv

load_dotenv()

class APIClient:
    def __init__(self):
        self.base_url = os.getenv("API_BASE_URL", "https://api.production.com")
        self.timeout = int(os.getenv("API_TIMEOUT", 10))
        # 新增：是否绕过代理，默认走代理（False）
        self.bypass_proxy = os.getenv("BYPASS_PROXY", "false").lower() == "true"

    def get_data(self, endpoint):
        url = f"{self.base_url}/{endpoint}"
        kwargs = {"timeout": self.timeout}
        if self.bypass_proxy:
            kwargs["proxies"] = {"http": None, "https": None}
        print(f"Connecting to: {url} (bypass_proxy={self.bypass_proxy})")
        return requests.get(url, **kwargs)

调试内网服务或开腾讯会议前，只需要在对应的 .env 里加一行：

BYPASS_PROXY=true

不需要再手动点开关梯子软件，也不用改代码——切回外网调试时，把这行删掉或设为 false 就行。

小结

• 环境变量解决”连哪个环境”：通过 API_BASE_URL 之类的变量，让代码在 dev/test/prod 之间自由切换，代码零改动。
• NO_PROXY / 代码级 proxies 参数解决”走不走代理”：同样是把易变的网络策略外部化，避免手动开关代理这种低效又容易忘的操作。

两者背后是同一套思想：把”会变的东西”从代码里挪出去，让代码只依赖一个稳定的名字（环境变量名），具体的值交给运行环境去决定。 这也是 12-Factor App 方法论里 Config 这一条反复强调的核心——配置和代码分离，才能让同一份代码在任何环境下都能跑起来，而不用改一行逻辑。