Package Control安装失败主因是网络拦截或校验失败，非脚本错误；2026年有效脚本为import urllib.request,os,hashlib;exec(urllib.request.urlopen('https://packagecontrol.io/installation').read().decode('utf-8'))，需确保Sublime能联网且返回内容未被篡改，哈希值应为df21e130d211cfc94d9b0905775a7c0f1e3d39e33b79698005270310898eea76。
Package Control 安装失败，不是脚本问题，是网络或校验被拦
控制台执行安装命令后没反应、报错或提示哈希不匹配，大概率不是你粘错了代码，而是请求被本地策略阻断。2026 年当前有效安装脚本是：import urllib.request,os,hashlib;exec(urllib.request.urlopen('https://packagecontrol.io/installation').read().decode('utf-8'))。但它的执行依赖两点：一是 Sublime 能连外网（部分企业防火墙会拦截 urllib.request.urlopen），二是返回内容未被中间设备篡改（否则 hashlib 校验失败）。
若失败，先检查杀毒软件/代理是否禁用了 Sublime 的网络访问；再手动核对下载内容 SHA256 值是否为 df21e130d211cfc94d9b0905775a7c0f1e3d39e33b79698005270310898eea76；最后可临时关闭 SIP（macOS）或 UAC（Windows）重试。
插件装不上，八成是没认准作者或版本冲突
Sublime 插件生态里同名插件泛滥，但维护状态天差地别。比如汉化必须选 ChineseLocalization（作者 wuub），乱码修复必须配 ConvertToUTF8（作者 kairyou）。装错分支或废弃版本，轻则功能无效，重则导致 Ctrl+Shift+P 面板打不开。
- 用
Ctrl+Shift+P→Install Package搜索时，务必点进详情页确认作者名和最后更新时间（2026 年仍在维护的插件通常更新在 6 月之后） - 已装插件出问题，直接删掉
Packages/插件名文件夹再重装，别指望“升级”能覆盖旧残留 -
Package Control自身若异常，删掉Installed Packages/Package Control.sublime-package后重启，它会自动重建
构建系统找不到编译器，PATH 没生效或路径含空格
配置 C++/Python/Java 构建时，shell_cmd 里调用 g++、python 或 javac 报 command not found，根本原因不是 Sublime 设置错了，而是终端能跑的命令，GUI 应用未必能继承到。
Windows 上常见于 MinGW 路径含空格（如 C:\Program Files\mingw64\bin），Sublime 默认不处理带空格路径；macOS/Linux 则常因 Shell 配置文件（.zshrc vs .bash_profile）没被 GUI 进程加载，导致 $PATH 缺失。
- Windows：把 MinGW 安装到无空格路径（如
C:\mingw64\bin），并在系统环境变量中添加该路径 - macOS：确保
export PATH="/usr/local/bin:$PATH"写在~/.zshrc，且启动 Sublime 前执行过source ~/.zshrc；更稳的方式是用subl命令从终端启动 - Linux：验证
which g++输出路径，然后在.sublime-build中显式写全路径，例如"shell_cmd": "/usr/bin/g++ -o \"$file_base_name\" \"$file\""
Python 虚拟环境不生效，项目配置里 interpreter 路径写错或没 reload
在项目文件（.sublime-project）里设了 python_interpreter，但 Ctrl+B 仍用系统 Python，说明路径没被真正读取，或 Sublime 没重新加载配置。
关键细节：路径必须是绝对路径，且指向虚拟环境里的 python 可执行文件（Windows 是 venv\Scripts\python.exe，macOS/Linux 是 venv/bin/python），不能只写到 venv 目录。
- 编辑项目文件后，必须保存并**关闭再重新打开项目**，Sublime 不会热重载 interpreter 设置
- 若用
SublimeREPL，需单独在它的设置里指定同一路径，它不复用构建系统的 interpreter - 路径含中文或符号（如
~/Projects/我的项目/venv/bin/python）会导致解析失败，一律用/Users/xxx/Projects/myproject/venv/bin/python这类完整形式
ConvertToUTF8，但没意识到它只在你右下角点击编码切换时才触发转换；又比如你写了正确的 python_interpreter，却忘了 Sublime 的项目配置只在以 Project → Open Project 方式打开时才加载。这些细节不显眼，但决定整个链路通不通。 
