同事说「host 这个接口有问题」，你打开文档翻了半天也没找到叫 host 的接口。不怪你，host 这个词在开发里至少有四种完全不同的含义，得先看他指的是哪个。

一、hosts 文件：本机域名解析

位置是 C:\Windows\System32\drivers\etc\hosts（Linux 在 /etc/hosts）。它的作用是在本机把域名直接指到一个 IP，优先于 DNS 服务器。做开发时把测试域名指到 127.0.0.1，就是改这个文件。

127.0.0.1   local.dev
10.0.0.5    db.internal

改完 Windows 上要 ipconfig /flushdns 清一次缓存。写错格式会导致整机域名解析异常，保存前先备份。

二、HTTP 请求头里的 Host

每个 HTTP 请求都会带 Host 头，告诉服务器你要访问哪个域名。一台服务器上放着几十个站点，靠这个字段区分。反向代理配置里的 proxy_set_header Host $host 就是把这个信息透传下去。

这也是为什么有时候直接用 IP 访问会打开另一个站点——Host 头不匹配，虚拟主机就把请求交给了默认站点。

三、接口文档里说的 host

很多 API 文档用一个变量 host 表示域名部分，比如 https://{host}/api/v1/users。这种写法是为了区分生产环境和测试环境，切换时只改 host。如果他说「host 接口有问题」，多半是指「通过这个域名调不通」，而不是某个叫 host 的函数。

四、编程语言里的 host 参数

Python 的 Flask 有 app.run(host='0.0.0.0')，Node 的 http.createServer().listen(port, host)，连接数据库的配置里也常有 host。意思都是「监听或连接的地址」，和接口没有关系。

怎么快速确认

  • 看上下文：聊配置就是 hosts 文件，聊网关和 Nginx 就是 Host 头，聊联调就是域名。
  • 抓一次包：浏览器开发者工具里看请求头的 Host 值，能直接判断请求到底打到了哪个域名。
  • 直接问清：与其猜，不如问一句「你说的是域名还是 hosts 文件」，这句话省半小时。

还有些场景把 host 当成主机名、容器名甚至消息队列的地址来用。遇到含糊的说法，先确认指的是文件、请求头、域名还是参数，问题往往说清了就解决了。