WorkBuddy安装时DNS解析异常的解决步骤包括：一、检查并备份resolv.conf；二、临时替换为可信DNS并验证解析；三、Windows刷新DNS缓存并修改适配器DNS；四、校验修正hosts文件错误映射；五、禁用systemd-resolved或NetworkManager自动覆盖。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装WorkBuddy时遇到域名无法访问、下载中断或提示“无法连接到服务器”，则极可能是安装程序尝试解析 cdn.codebuddy.cn、www.codebuddy.cn 或 workbuddy.qq.com 时发生DNS解析异常。以下是解决此问题的步骤：
一、检查并备份当前 resolv.conf（Linux/macOS）
Linux与macOS系统中，/etc/resolv.conf 是DNS解析配置的核心文件；若其被动态服务覆盖或内容错误，将直接导致WorkBuddy安装包域名无法解析。需先确认其真实状态并保留原始配置以备回退。
1、在终端中执行 ls -l /etc/resolv.conf，查看是否为符号链接及其指向路径。
2、若输出中显示指向 /run/systemd/resolve/stub-resolv.conf 或 /run/NetworkManager/resolv.conf，说明该文件由 systemd-resolved 或 NetworkManager 动态管理。
3、执行 sudo cp /etc/resolv.conf /etc/resolv.conf.bak，完成配置备份。
二、临时替换为可信公共DNS并验证解析
绕过当前可能失效或污染的DNS配置，直接使用已知高可用、低延迟且支持HTTPS DNS的公共解析器，可快速验证是否为本地DNS问题，并立即恢复安装流程。
1、执行 echo "nameserver 114.114.114.114" | sudo tee /etc/resolv.conf，写入国内权威DNS（备用可追加 nameserver 223.5.5.5）。
2、运行 dig +short cdn.codebuddy.cn，确认返回非空且为腾讯云CVM公网IP（如以 100. 或 182. 开头）。
3、若返回为空或超时，改用 dig @1.1.1.1 +short cdn.codebuddy.cn 强制指定Cloudflare DNS测试，排除本机配置干扰。
三、Windows平台刷新DNS缓存并修改网络适配器DNS
Windows系统默认使用ISP提供的DNS，易受劫持、缓存污染或响应延迟影响；WorkBuddy安装器依赖稳定解析结果获取CDN资源，需同步清理缓存并固化可靠DNS地址。
1、以管理员身份打开命令提示符，执行 ipconfig /flushdns 清除本地DNS解析缓存。
2、进入“控制面板 → 网络和 Internet → 网络和共享中心 → 更改适配器设置”，右键当前网络连接，选择“属性”。
3、双击“Internet 协议版本 4 (TCP/IPv4)”，勾选“使用下面的 DNS 服务器地址”，填入：首选 114.114.114.114，备用 223.5.5.5。
4、点击“确定”保存后，在命令提示符中执行 ipconfig /renew 更新网络参数，再运行 nslookup cdn.codebuddy.cn 验证解析结果。
四、校验并修正 hosts 文件中的错误映射
hosts文件具有最高解析优先级；若其中存在对 cdn.codebuddy.cn、www.codebuddy.cn 或 workbuddy.qq.com 的错误静态绑定（如指向 127.0.0.1、0.0.0.0 或私有IP），将彻底屏蔽DNS查询，导致安装器静默失败。
1、Windows用户：按下 Win + R，输入 notepad %windir%\System32\drivers\etc\hosts，以管理员身份运行记事本。
2、macOS/Linux用户：在终端中执行 sudo nano /etc/hosts。
3、逐行查找包含 codebuddy 或 workbuddy 的行，对任何指向非腾讯云IP的条目，在行首添加 # 注释掉。
4、保存文件后，再次执行 nslookup cdn.codebuddy.cn（Windows）或 dig +short cdn.codebuddy.cn（macOS/Linux）确认解析已恢复正常路径。
五、禁用systemd-resolved或NetworkManager的自动覆盖行为
当确认 systemd-resolved 或 NetworkManager 是导致 /etc/resolv.conf 被反复重置的根源时，必须停用其对DNS配置的接管能力，否则手动配置将在下次网络事件后丢失，无法保障WorkBuddy安装过程的连续性。
1、若 systemctl is-active systemd-resolved 返回 active，则执行 sudo systemctl stop systemd-resolved && sudo systemctl disable systemd-resolved。
2、若使用 NetworkManager，编辑其配置文件：sudo nano /etc/NetworkManager/NetworkManager.conf，在 [main] 段落下添加 dns=none。
3、执行 sudo systemctl restart NetworkManager，随后手动重建 /etc/resolv.conf 并设为只读：sudo chattr +i /etc/resolv.conf。
