httpx 通过 Client 的 proxies 参数设置代理，支持字符串或字典形式；跳过特定域名需传入 callable 函数；不自动读取 NO_PROXY 环境变量；异步 client 中 callable 不可 await，且每次请求（含重定向）均执行。
httpx 怎么设置全局代理（含 HTTP/HTTPS）
httpx 本身不提供“全局代理”概念，但可以通过 httpx.Client 或 httpx.AsyncClient 的 proxies 参数统一配置。它支持字符串形式（如 "https://www.php.cn/link/1ce5e897cda6aeb211dffe8d514f4365"）或字典形式，后者更灵活，能分别指定 http:// 和 https:// 流量的代理：
proxies = {
"http://": "https://www.php.cn/link/1ce5e897cda6aeb211dffe8d514f4365",
"https://": "https://www.php.cn/link/1ce5e897cda6aeb211dffe8d514f4365", # 注意：httpx 支持 HTTPS 流量走 HTTP 代理（CONNECT）
}注意：httpx 不支持直接用 https:// 代理地址（即 TLS over TLS），会报 ProxyError；若需 HTTPS 代理，得用支持 TLS tunneling 的代理服务（如 mitmproxy、squid 配置了 CONNECT），且仍用 http:// 前缀填写地址。
怎么跳过特定域名（如 localhost、127.0.0.1、内部域名）
httpx 没有内置的 no_proxy 解析逻辑，但支持传入一个可调用对象（callable）作为 proxies 值，由你自行控制是否代理。这是最可靠、最可控的方式：
- 函数接收一个
url（httpx.URL实例），返回代理 URL 字符串，或返回None表示不代理 - 可以基于
url.host、url.port、url.scheme做判断 - 推荐用
urllib.parse.urlparse或直接用url.host（httpx 0.24+ 已稳定）做匹配
示例（跳过 localhost、127.0.0.1、.test 域名）：
立即学习“Python免费学习笔记（深入）”；
def proxy_selector(url):
host = url.host
if host in ("localhost", "127.0.0.1") or host.endswith(".test"):
return None
return "https://www.php.cn/link/1ce5e897cda6aeb211dffe8d514f4365"
<p>client = httpx.Client(proxies=proxy_selector)为什么不能直接用环境变量 NO_PROXY？
httpx 默认**不读取** NO_PROXY 环境变量 —— 这和 requests 不同。即使你设置了 NO_PROXY=localhost,127.0.0.1，httpx 也不会自动识别。
如果你依赖环境变量，必须手动解析并封装进 callable：
import os
from urllib.parse import urlparse
<p>no_proxy_hosts = [h.strip() for h in os.getenv("NO_PROXY", "").split(",") if h.strip()]</p><p>def proxy_selector(url):
host = url.host
if any(host == h or host.endswith(f".{h}") for h in no_proxy_hosts):
return None
return "<a href="https://www.php.cn/link/1ce5e897cda6aeb211dffe8d514f4365">https://www.php.cn/link/1ce5e897cda6aeb211dffe8d514f4365</a>"注意：NO_PROXY 的匹配规则是「精确主机名」或「以 .domain 结尾」，不是通配符，也不是子域名自动包含（.example.com 不匹配 api.example.com，除非你显式写成 .example.com 并用 endswith 判断）。
异步 client 和 session 复用时要注意什么
使用 httpx.AsyncClient 时，proxies 同样支持 callable，逻辑一致。但要注意：
- 代理 callable 是同步函数，httpx 内部会同步调用它（不 await），所以不要在里面写
await - 如果用
httpx.Client配合mount或自定义 transport，代理逻辑会被绕过 ——proxies只在默认 HTTPTransport 下生效 - 多个 client 实例之间不共享代理状态，每个 client 都要单独传
proxies - 若用
httpx.Timeout或httpx.Limits，它们与代理无关，但超时可能掩盖代理连接失败的真实原因（比如代理宕机却只报ConnectTimeout）
真正容易被忽略的是：代理 callable 在每次请求时都会执行，包括重定向后的 URL —— 所以如果你跳过了原始域名但重定向到了代理域名，它仍会走代理；反之亦然。需要确保逻辑覆盖所有跳转目标。
