Gist插件必须配置GitHub Personal Access Token（带gist权限）才可用，密码认证已失效；未配置或配置错误会导致命令静默失败或报401错误。
Sublime Text 的 Gist 插件现在必须用 Personal Access Token（PAT）才能登录，密码认证已彻底失效；不配置 token，所有 Gist 命令都会静默失败或报 401 Unauthorized。
安装 Gist 插件前先确认 Package Control 已就位
如果还没装 Package Control，别跳过这步——Gist 插件无法通过拖文件或手动解压方式可靠运行。打开 Sublime Text，按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Install Package 并回车；等待列表加载完成后，再输 Gist，选中 Gist（作者 condemil）安装。安装完无需重启，但后续配置必须手动触发。
配置 token 时容易漏掉的三个细节
插件不再接受用户名+密码，只认 GitHub 的 Personal Access Token，且必须带 gist 权限。常见卡点：
- token 必须在 https://www.php.cn/link/9c450eb90c31bc12f1691f235da5a0cc 页面生成，勾选
gist复选框——只勾repo或留空都不行 - 配置文件路径是
Preferences → Package Settings → Gist → Settings – User，打开后直接填"token": "ghp_abc123..."，不要加注释、不要换行、不要用单引号 - 保存后别急着试命令，先关掉所有 Sublime 窗口再重开——插件不会热重载配置，旧进程仍会用空 token 请求 API
创建和打开 Gist 的实际操作边界
这个插件不是“云笔记”，它只同步纯文本内容，不保留光标位置、折叠状态或语法高亮设置：
-
Gist: Create Public Gist和Gist: Create Private Gist都要求当前标签页有内容（哪怕未保存），空文件会无响应 -
Gist: Open Gist搜索时匹配的是Description字段，不是文件名或代码内容；建议统一用lang:name格式，比如Python:requests-get-with-timeout - 修改已打开的 Gist 后，必须用
Gist: Update File才能提交变更；直接 Ctrl+S 只保存本地副本，远端毫无变化
私有 Gist 同步失败的典型现象与验证方法
如果你设置了 "private": true 却发现 Gist 总是公开的，或者 Gist: Open Gist 列表里看不到自己的私有片段，大概率是 token 权限或网络问题：
- 用 curl 手动验证：执行
curl -H "Authorization: token ghp_abc123..." https://api.github.com/gists，返回含"public": false的条目才说明 token 有效且私有 Gist 可见 - 国内用户常因 DNS 或中间代理导致请求被截断，此时 Sublime 控制台（
Ctrl+`）会显示error: HTTPSConnectionPool(host='api.github.com', port=443): Max retries exceeded - 插件本身不缓存 Gist 列表，每次
Gist: Open Gist都发起新请求——没反应时多等 3–5 秒，别连按快捷键
token 一旦写错或过期，插件不会主动提醒，所有操作都像“点了没反应”；最稳的验证方式永远是：删掉配置里的 token 行 → 重启 Sublime → 看 Gist: Open Gist 是否立刻报错 —— 有错说明插件在读配置，没错说明它根本没加载到你的设置文件。
