SwitchHosts! 中文介绍与使用教程：Windows 下快速切换 hosts 方案

在开发、测试、联调时，经常需要在「本地环境 / 测试环境 / 生产环境」之间来回改 hosts 文件。手动打开 C:\Windows\System32\drivers\etc\hosts 反复注释、取消注释，既容易漏改也容易改错。SwitchHosts! 就是专门解决这件事的免费开源工具：把不同环境的 hosts 存成多套「方案」，点一下即可切换。

SwitchHosts! 由 oldj 开发，基于 Apache-2.0 协议开源，支持 Windows、macOS、Linux，自带简体中文界面，是目前最主流、仍在活跃维护的 hosts 管理方案。最新版本为 v5.0.3（2026 年 10 月发布）。

一、主要功能特性

v5.0.3 还新增了通过 DoH 批量把域名解析为 hosts 条目、导入前预览并选择追加或替换、历史记录管理、自定义 API 端口等功能，并改进了编码兼容（BOM / UTF-16 / 旧版 ANSI）与多处切换稳定性修复。

二、下载与安装（Windows）

1. 从 GitHub Releases 下载最新版安装包 SwitchHosts-5.0.3-windows-x64-setup.exe，或从文末网盘获取。
2. Windows 版安装包仅约 3.4 MB，因为它调用系统自带的 WebView2 显示界面。正常的 Windows 10 / 11 已内置该组件；若用的是精简版系统或公司电脑策略禁用了它，打开软件会没有界面，安装一次「Microsoft Edge WebView2 Runtime」即可。
3. 双击安装，也可以用 Chocolatey 安装：choco install switchhosts。
4. 升级时直接运行新版安装包覆盖安装即可，原有方案不受影响。

注意：修改 hosts 属于系统级操作，首次运行时会弹出 UAC 管理员授权提示，正常放行即可。如果拒绝授权，方案将无法写入系统 hosts。

三、基本使用方法

1. 新建一套方案

打开 SwitchHosts!，点击左侧「+」新建方案，选择类型：

• 本地方案：内容由自己编辑保存，最常用；
• 远程方案：填一个 URL，软件会拉取远程 hosts 内容并可定时自动更新，适合团队共用一份配置。

给方案起个一眼能认出的名字，例如「本地开发」「测试环境」「生产环境」「客户端 A」。

2. 编辑 hosts 内容

在右侧编辑器里按标准格式书写，一行一条，IP 与域名之间用空格或制表符分隔，# 后面是注释：

# 本地开发
127.0.0.1   api.example.test
127.0.0.1   web.example.test
192.168.1.20   db.internal

编辑器带语法高亮；点行号或按 Ctrl + / 可快速注释某行；也可用文件夹把方案分组管理，还能对整个文件夹一键启用 / 停用。

3. 启用与切换方案

• 在方案名前勾选即启用，取消勾选即停用；可以同时勾选多套方案，它们会合并生效，方便组合出复杂环境。
• 点击系统托盘图标，在弹出菜单里直接点选方案即可快速切换，无需打开主窗口。
• 改完记得让配置生效（见下一步）。

4. 让配置生效（关键一步）

SwitchHosts! 会把启用的方案写入系统 hosts 文件，但不会自动刷新 DNS 缓存，所以切换后建议：

1. 按 Win + R 输入 cmd 回车，执行 ipconfig /flushdns 刷新 DNS 缓存；
2. 重启浏览器，或用 Ctrl + F5 强制刷新页面；
3. 若仍不生效，检查是否开了 VPN、AdGuard、NextDNS、代理软件或企业 DNS 策略——它们可能覆盖 hosts 的解析结果。

5. 命令行调用（可选）

Windows 安装版会自动把安装目录加入 PATH 并创建 swh 命令，重开终端后就能用：

swh --cli list               # 列出所有方案
swh --cli status             # 查看当前启用状态
swh --cli on "本地开发"       # 启用指定方案
swh --cli off "生产环境"      # 停用指定方案
swh --cli toggle "Test/API"  # 切换（支持 文件夹/方案 路径写法）
swh --cli apply              # 应用当前配置到系统 hosts

适合把 hosts 切换写进脚本或批处理里，做自动化环境准备。

6. 备份、导入导出与误操作恢复

• 备份位置：所有方案保存在用户目录下的 .SwitchHosts 文件夹（data 放数据，config 放配置）。重装系统前复制出来，装好后放回原位即可全部恢复。
• 分享给同事：用软件内的「导出」生成文件，对方「导入」即可；v5.x 导入前可先预览，再选择追加条目或整体替换。
• 改错了：软件会保留系统 hosts 的历史版本，删除的方案先进回收站，都能找回。

四、常见问题

五、下载地址

• GitHub 官方下载（最新版 Releases）：https://github.com/oldj/SwitchHosts/releases
• 项目主页：https://switchhosts.app
• 百度网盘下载：https://pan.baidu.com/s/1rpilxG8FWsBoz6TwC46u3Q　提取码：u5un

SwitchHosts! 为免费开源软件（Apache-2.0）。建议优先从 GitHub Releases 获取最新版；网盘链接方便网络访问 GitHub 不畅时备用，下载后建议核对文件版本。

小结

如果你只是偶尔改一两条 hosts，Windows 自带的记事本或微软 PowerToys 里的 Hosts File Editor 就够用；但只要涉及多套环境来回切换，SwitchHosts! 几乎是 Windows 上的标配：免费、中文、体积小巧、托盘一键切换，还带语法高亮、远程同步、历史版本和命令行。把方案按环境分好，切换时勾一下再刷新 DNS，就能彻底告别手动注释 hosts 的日子。