修改下载源和hosts文件可解决Sublime插件安装失败问题。首先通过Package Control设置将默认源替换为Gitee镜像，提升国内访问速度；其次在系统hosts文件中添加raw.githubusercontent.com、github.com等域名的正确IP映射，避免DNS解析失败；最后检查代理、防火墙设置是否阻止连接。通常组合使用前两步即可修复“Unable to download package”等问题，若仍失败可尝试重装Package Control或切换网络环境。
Sublime Text 使用过程中，通过 Package Control 安装插件失败是常见问题，多数由网络连接异常引起。下面分析常见原因并提供实用修复方法。
一、Package Control 网络错误的常见原因
Sublime 的 Package Control 默认从 GitHub 下载插件包，若网络访问受限，会导致安装失败。主要问题包括：
- 无法连接到 raw.githubusercontent.com 或 github.com 域名
- DNS 污染或解析失败
- 本地防火墙或代理设置阻止 HTTPS 请求
- 系统 hosts 文件未正确配置国外域名映射
错误提示通常为："Unable to download package"、"Connection refused" 或 "SSL error"。
二、手动修改 Package Control 配置（推荐）
通过替换默认下载源，绕过网络限制：
- 打开 Sublime Text，点击菜单 Preferences → Package Settings → Package Control → Settings – User
- 在右侧配置文件中添加以下内容：
{
"channels": [
"https://gitee.com/lcfvs/PackageControlChannel/raw/master/channel.json"
],
"repositories": [
"https://gitee.com/lcfvs/SublimePackageControl"
],
"downloader_precedence": {
"linux": ["curl", "wget", "urllib"],
"osx": ["curl", "wget", "urllib"],
"windows": ["wininet"]
}
}
该配置将默认 GitHub 源替换为 Gitee 镜像，提升国内访问成功率。
三、配置系统 hosts 提高连接稳定性
手动绑定关键域名 IP，避免 DNS 解析失败：
- 编辑系统 hosts 文件（路径：Windows 在
C:\Windows\System32\drivers\etc\hosts，macOS/Linux 在/etc/hosts） - 添加以下行（IP 可能变动，建议使用最新可用地址）：
199.232.68.133 raw.githubusercontent.com 140.82.114.4 github.com 185.199.108.133 gitee.com
保存后刷新 DNS 缓存（命令行执行 ipconfig /flushdns 或 sudo dscacheutil -flushcache）。
四、检查代理与防火墙设置
若你在公司网络或使用代理工具，需确认 Sublime 能正常联网：
- 关闭不必要的代理软件，或确保代理已正确配置
- 临时关闭杀毒软件或防火墙测试是否拦截连接
- 在企业网络中可能需要联系 IT 开放对 GitHub 的访问权限
基本上就这些。多数情况下，修改 channel 源 + hosts 绑定即可解决安装失败问题。如果仍不行，可尝试重装 Package Control 或更换网络环境。操作不复杂，但细节容易忽略。
