VSCode中配置Node环境实现本地DNS拦截，核心是让Node进程网络请求走指定IP而非公网DNS，需通过代码patch net.connect或http.Agent lookup、在launch.json env中注入映射规则，或使用Dev Proxy反向路由替代DNS层操作。
VSCode 里配 Node 环境做本地 DNS 拦截，不是装个插件就能“自动映射域名”，核心在于让 Node 进程发起的网络请求（比如 fetch、axios、http.request）实际走你指定的 IP 和端口，而不是真实解析公网 DNS。这需要两层配合：一是让 Node 进程绕过系统 DNS，二是确保 VSCode 调试器能继承这个控制逻辑。
Node.js 启动时强制覆盖 DNS 解析行为
Node 自带 dns.setServers() 可以在运行时替换 DNS 服务器，但它只影响 dns.resolve* 系列调用，对 http/https 模块无效——后者底层仍走系统 getaddrinfo。真正生效的是环境变量 NODE_OPTIONS + --dns-result-order 或更直接的 --host 参数（仅限 Node 18.17+），但最稳定通用的方式是用 globalAgent + lookup 选项。
- 在启动脚本或
launch.json的env字段里加：NODE_OPTIONS="--experimental-permission --no-warnings"（非必需，但避免权限警告干扰） - 在代码入口（如
index.js开头）手动 patchrequire('net').connect或使用http.Agent覆盖lookup函数，例如：
const net = require('net');
const originalConnect = net.connect;
net.connect = function(...args) {
if (typeof args[0] === 'object' && args[0].host) {
// 把 dev.example.com → 127.0.0.1:3000
if (args[0].host === 'api.dev.example.com') {
args[0].host = '127.0.0.1';
args[0].port = 3000;
}
}
return originalConnect.apply(this, args);
};
这种方式不依赖外部工具，调试时断点可下、堆栈清晰，但只对 Node 原生模块生效；若项目用了 undici 或 node-fetch v3+，需额外 patch undici 的 lookup 选项。
VSCode launch.json 中必须显式注入 host 映射逻辑
很多人把 DNS 拦截逻辑写在代码里，却忘了 VSCode 调试器默认不会运行 package.json 的 scripts，而是直执行 node index.js —— 此时你的 patch 代码可能还没加载，请求已发出。所以不能只靠“启动前改 hosts 文件”或“全局代理”，必须让调试进程从第一行就携带规则。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 在
.vscode/launch.json的配置中，用env传入自定义变量，再在入口文件里读取并触发 patch： "env": { "LOCAL_DNS_MAP": "api.dev.example.com:127.0.0.1:3000,web.dev.example.com:127.0.0.1:8080" }- 然后在
index.js顶部解析该字符串，动态 patchnet.connect或http.globalAgent - 别用
preLaunchTask执行 shell 脚本改系统/etc/hosts：它不可靠（权限、多用户、Docker 容器内失效），且无法作用于调试进程的 DNS 缓存
用 Dev Proxy 做反向路由比 DNS 拦截更可控
如果你的目标只是让前端请求 https://api.dev.example.com/users 打到本地 localhost:3000，其实不需要碰 DNS 层。Dev Proxy（如 Microsoft Dev Proxy）本质是 HTTP 层代理，它通过修改请求 Host 头 + 转发到目标地址，完全绕开 DNS 解析，还支持模拟错误、延迟、重定向等测试场景。
- 安装 Dev Proxy：
dotnet tool install -g Microsoft.DevProxy（需 .NET SDK） - 写规则文件
devproxy.rules.json：
{
"rules": [
{
"url": "https://api.dev.example.com/**",
"destination": "http://localhost:3000/",
"method": "GET|POST|PUT|DELETE"
}
]
}
- 在
launch.json中启动 Dev Proxy 并设置环境变量： "env": { "HTTP_PROXY": "http://127.0.0.1:8000", "HTTPS_PROXY": "http://127.0.0.1:8000", "NODE_TLS_REJECT_UNAUTHORIZED": "0" }-
"preLaunchTask": "start-dev-proxy"（对应 tasks.json 里启动devproxy --config devproxy.rules.json）
这样所有 Node 进程的 HTTP 请求都会被拦截重写，无需改代码，也不依赖系统 DNS 配置，适合 CI/CD 或多人协作环境。
真正容易被忽略的是：Node 的 dns 模块缓存和 http.Agent 的 socket 复用会掩盖映射是否生效。每次改完规则，务必清空 node_modules/.cache（如果有）、重启 VSCode 终端、并在调试控制台里手动 require('dns').lookup('api.dev.example.com', console.log) 验证返回值——别只看接口是否通，要看底层解析结果是否如预期。
