package control装不上需先确认sublime text版本并使用对应安装脚本：st4无需手动安装，st3须用官方最新哈希码（如h='6f4c264a...'）；控制台务必用ctrl+`打开，完整粘贴脚本（不删空格、不换行）执行。
Package Control 装不上？先确认控制台执行的是哪段代码
很多人卡在第一步：粘贴完代码按回车，控制台只闪一下就没了，或者报 urllib.error.URLError、hash mismatch。这不是网络问题，而是用了过期的安装脚本。
Sublime Text 4（Build 4126+）已默认内置 Package Control，无需手动安装；但如果你用的是 ST3（Build 3217 或更老），必须用对应版本的哈希校验码。官方当前有效脚本以 h = '6f4c264a24d933ce70df5dedcf1dcaee' 开头（截至 2026 年 8 月），旧脚本如 h = '7183a2d3e96f11eeadd761d777e62404' 已失效。
- 打开控制台用
Ctrl+`，别用菜单里的 “Show Console” —— 某些版本菜单入口会启动错误上下文 - 复制完整脚本（含
import urllib.request,os,hashlib;开头那一整段），**不要删空格、不要换行** - 执行后若无报错且左下角出现
Package Control提示，说明成功；若提示Error validating download，立刻停手，换新脚本
Python 构建系统为什么总报 “python: command not found”
不是 Python 没装，是 Sublime 在子进程里找不到它。Windows 和 macOS 的 PATH 继承逻辑不同，ST 默认不读取 shell 配置文件（如 .zshrc 或 PATH 环境变量）。
最稳的解法是显式写死路径，而不是依赖 "cmd": ["python", "-u", "$file"]：
- 在终端运行
which python3（macOS/Linux）或where python（Windows），拿到绝对路径，比如/opt/homebrew/bin/python3或C:\Users\name\AppData\Local\Programs\Python\Python311\python.exe - 新建构建系统时，
"cmd"字段必须用数组形式：["/opt/homebrew/bin/python3", "-u", "$file"]，不能写成字符串"python3 -u $file" - 如果用 conda 或 venv，路径要指向具体环境里的解释器，例如
~/miniconda3/envs/myenv/bin/python，而非 base 环境
中文乱码、保存失败、“Permission denied” 这三类报错其实是一个根因
它们都指向同一个底层问题：Sublime 启动方式绕过了用户 session 权限模型。尤其是 macOS 上通过 Spotlight 或 Dock 启动的 ST，会以 minimal environment 运行，既读不到 $HOME/.zprofile，也拿不到 GUI 应用所需的文件访问授权。
解决方法不是改编辑器设置，而是改启动入口：
- macOS：必须用终端启动 —— 执行
subl命令（前提是已运行过subl --install）；否则右键菜单或双击.app 都会出权限问题 - Windows：安装时务必勾选
Add to PATH和Add to explorer context menu；若已装好，去“设置 > 应用 > 启动项”里确认subl是否启用 - Linux：避免用 snap 安装，改用官网 .deb 或 .tar.bz2 包；snap 沙盒会拦截
/tmp和用户目录写入
插件装了但没反应？检查 selector 和 ignored_packages
比如 Anaconda 插件装完，Ctrl+Space 不弹补全，大概率是 "selector": "source.python" 和你当前文件的语法 scope 对不上。Sublime 的语法识别靠文件扩展名 + 手动设置的 syntax，不是靠内容猜。
验证方式：按 Ctrl+Shift+P → 输入 View Package File → 打开当前文件的 .sublime-syntax 文件，看第一行 file_extensions: 是否包含 py；再按 Ctrl+Alt+Shift+P 查看当前光标位置的 scope，必须含 source.python 才生效。
- 常见干扰项：
"ignored_packages": ["Python"]会禁用原生 Python 支持，导致所有 Python 相关插件失效 - ChineseLocalization 插件需重启才生效，且仅影响菜单和对话框，不影响代码高亮或构建系统
- SublimeREPL 启动失败常因 Python 路径不对，它不走构建系统，而是直接调
python -i，所以得单独配repl_python.py里的 interpreter_path
Ctrl+Alt+Shift+P 输出的 scope，比重装十遍都管用。
