sublime text必须按版本使用对应脚本安装package control：st4用哈希以6f4c264a开头、请求https://packagecontrol.io/的脚本，st3用bf11abc3或7183a2d3开头脚本；错版会导致命令面板无install package选项。
Package Control装不上？先确认控制台执行的是哪段代码
Sublime Text 3 必须先装 Package Control 才能装其他插件，但网上流传的安装代码有多个版本，容易粘错导致 silent fail（没报错但没装上）。最稳妥的是用官方当前推荐的那段——它带 SHA256 校验，失败会明确输出 Error validating download。
常见错误现象：
- 执行完控制台没反应，重启后
Ctrl+Shift+P输Install Package找不到命令 - 控制台报
NameError: name 'sublime' is not defined——说明 Sublime 还没完全初始化，得等几秒再粘代码 - Windows 上
Ctrl + `被 QQ 或微信快捷键劫持，得先关输入法热键
实操建议：
- 打开控制台后，等右下角状态栏显示 “Ready” 再粘代码
- 复制时注意别把换行或空格带进去，整段必须是一行（哪怕看起来很长）
- 如果卡住或报错，直接删掉
%APPDATA%\Sublime Text 3\Installed Packages\Package Control.sublime-package文件重试
Python开发环境跑不起来？Build System路径和参数要对齐
装完 Package Control 后，很多人直接新建 Python.sublime-build 就以为能运行 .py 文件，结果点 Ctrl+B 没反应，或者报 'python' is not recognized。
根本原因不是插件问题，而是 Build System 配置里 "cmd" 的路径写死了，而你本地 Python 可能装在 C:\Users\XXX\AppData\Local\Programs\Python\Python311\python.exe，也可能用 conda 管理，路径完全不同。
实操建议：
- 不要手敲路径，用命令行查真实位置：
where python（Windows）或which python3（macOS/Linux） -
"cmd"数组里第一项必须是绝对路径，不能写python；第二项-u很关键，否则 print 输出会缓冲、看不到实时日志 - 如果用虚拟环境，把路径指向
venv/Scripts/python.exe（Windows）或venv/bin/python（macOS/Linux） - 保存后，务必去
Tools > Build System手动选中你刚建的那个名字，否则默认还是None
中文乱码、缩进错乱、自动补全失效？Settings(User)里这几项不能漏
很多用户装完插件就以为万事大吉，结果写中文注释变方块、Tab 键缩进 8 格、函数名打一半没提示——其实是 Sublime 默认配置和 Python 社区惯例不一致。
关键配置项（写在 Preferences > Settings – User 右侧）：
-
"font_face": "Consolas"或"Fira Code"，避免系统默认字体不支持编程符号 -
"tab_size": 4和"translate_tabs_to_spaces": true，这是 PEP 8 强制要求 -
"detect_indentation": false，否则打开旧文件时 Sublime 会自作主张改你缩进，引发 Git diff 灾难 -
"draw_white_space": "all"，方便肉眼识别空格和 tab 混用 -
"auto_complete": true且"auto_complete_commit_on_tab": true，不然补全要按两次 Tab
注意："ignored_packages" 里一定要去掉 "Vintage"，否则 Esc 键会进 Vim 模式，光标突然消失。
Emmet、BracketHighlighter、AutoFileName这些“刚需”插件怎么装才稳
装插件本身很简单，但顺序和依赖关系容易被忽略。比如 Emmet 在 Sublime Text 4 之后需要 PyPI 支持，而 AutoFileName 依赖 SideBarEnhancements 才能右键插入路径。
推荐安装顺序和要点：
- 先装
SideBarEnhancements：它让右键菜单支持新建文件、复制路径、刷新目录，是后续插件的基础 - 再装
Emmet：装完后按Ctrl+E测试，输入ul>li*3回车应生成完整 HTML 列表；如果没反应，检查是否在.html或.css文件里（默认不激活.py） -
BracketHighlighter要手动启用高亮：装完后Ctrl+Shift+P输BracketHighlighter: Settings – User，加一行"highlight_bracket_contents": true -
AutoFileName对import补全无效，它只管字符串里的路径，比如open("data/xxx.csv")里双引号内自动补全
插件装完记得重启 Sublime，有些插件（如 SublimeLinter）需要额外配置 Python 解释器路径才能工作，别指望一键开箱即用。
