sublime text 4 中官方gist插件不可用,因其依赖已弃用的python 2.7和github旧api;替代方案为手动curl(轻量可靠)或sublimegit+本地gist仓库(稳定但需手动克隆)。

Sublime Text 本身不内置 Gist 功能,必须通过插件实现;但官方 Gist 插件(Gist)已多年未维护,2026 年在 Sublime Text 4 下基本不可用——直接安装会报错或无法登录 GitHub。
为什么 Gist 插件在 Sublime Text 4 中大概率失败
原 Gist 插件依赖 Python 2.7 和旧版 GitHub API(v3 OAuth),而 Sublime Text 4 默认使用 Python 3.8+,且 GitHub 已全面停用密码/OAuth token 方式创建 gist(要求使用 fine-grained personal access token + 更严格的 scope)。插件未更新适配,调用 urllib2 或硬编码的 endpoint 会直接抛出 HTTP Error 401 或 SSL: CERTIFICATE_VERIFY_FAILED。
- 常见错误现象:
AttributeError: module 'urllib' has no attribute 'urlopen'、KeyError: 'id'(解析空响应)、状态栏显示Gist: Login failed却无进一步提示 - 即使手动填入 token,插件也不支持
gist:writescope 的校验逻辑,token 被静默忽略 - 插件配置文件
Gist.sublime-settings中的"github_token"字段形同虚设
替代方案:用 SyncedSideBar + 手动 curl(轻量可靠)
不依赖插件,5 分钟内完成 gist 创建与分享,全程可控、无兼容风险。
- 第一步:生成 GitHub Personal Access Token
访问 https://www.php.cn/link/9c450eb90c31bc12f1691f235da5a0cc,勾选gistscope(注意不是repo),生成后复制 token(只显示一次) - 第二步:在 Sublime 中选中代码 → 右键 →
Copy File Path或手动记下当前文件路径 - 第三步:终端执行(替换
YOUR_TOKEN和file.cpp):curl -X POST \ -H "Authorization: token YOUR_TOKEN" \ -H "Accept: application/vnd.github.v3+json" \ -d '{"description":"Quick snippet","public":true,"files":{"file.cpp":{"content":"'$(base64 -i file.cpp | tr -d '\n')'"}}}' \ https://api.github.com/gists - 返回 JSON 中的
html_url字段即为可分享链接,直接粘贴给同事即可
如果坚持要图形化操作:改用 SublimeGit 配合本地 gist repo
SublimeGit 是目前 Sublime Text 4 下唯一持续更新、支持 Git 操作的插件,它不直连 GitHub Gist API,但可通过「本地克隆 gist 仓库」方式间接管理。
- 前提:你的 gist 已通过命令行
git clone git@gist.github.com:xxx.git克隆到本地(gist URL 可从 GitHub 网页端获取) - 在 Sublime 中用
Ctrl+Shift+P→Git: Init打开该目录,再用Git: Add+Git: Commit+Git: Push更新 gist - 注意:每次新增 gist 需手动
git clone一次,不能一键创建新 gist,但编辑/更新已有 gist 稳定可靠 - 避免踩坑:不要用
SublimeGit的Git: Clone命令直接拉取 gist URL(它不识别 gist 的特殊 remote 格式),必须用终端先完成首次 clone
真正卡住人的从来不是“怎么装插件”,而是 GitHub 认证机制变了、Python 运行时升级了、插件作者停更了——这些细节不会出现在安装步骤里,但决定了你花 20 分钟还是 2 分钟搞定分享。











