应重新配置 GitHub Personal Access Token 并确保具备 gist 权限,或切换至 GitHub App Authentication 模式完成授权,必要时清除 GistPad 本地缓存并刷新 Gists。

如果您希望在 VSCode 中直接浏览、创建、编辑和同步 GitHub Gists,但插件未正常显示 Gist 列表或无法登录 GitHub 账户,则可能是由于认证令牌配置错误或扩展权限未正确授予。以下是解决此问题的步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、重新配置 GitHub Personal Access Token
GistPad 依赖有效的 GitHub Personal Access Token 进行身份验证,若 Token 过期、权限不足或未正确粘贴,将导致 Gist 无法加载。需确保 Token 具备 gist 范围权限,并通过插件设置界面重新输入。
1、访问 GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)。
2、点击 Generate new token → Generate new token (classic)。
3、在 Note 字段填写“GistPad-token”,勾选 gist 权限,其余不选,点击 Generate token。
4、复制生成的 token 字符串(仅此一次可见)。
5、在 VSCode 中按 Cmd+Shift+P,输入并选择 GistPad: Set GitHub Token,粘贴并回车。
二、切换至 GitHub App Authentication 模式
GistPad 支持基于 OAuth 的 GitHub App 认证方式,可绕过手动 Token 管理,避免因 Token 失效导致的登录中断。该方式通过 GitHub 官方应用授权流程完成,安全性更高且无需复制密钥。
1、按 Cmd+Shift+P,输入并选择 GistPad: Login with GitHub App。
2、VSCode 将打开系统默认 浏览器,跳转至 GitHub 授权页面。
3、点击 Authorize gistpad 按钮,允许访问您的 gists。
4、授权完成后,浏览器页面显示“Success”,VSCode 侧边栏 GistPad 视图将自动刷新并列出全部 Gist。
三、重置 GistPad 本地缓存与状态
GistPad 会在本地存储 Gist 元数据及会话状态,若缓存文件损坏或版本升级后结构不兼容,可能导致界面空白或操作无响应。清除缓存可强制插件重建索引,恢复基础功能。
1、关闭 VSCode 所有窗口。
2、在终端执行命令:rm -rf ~/.vscode/extensions/loilo.vscode-gistpad-*/cache。
3、重新启动 VSCode。
4、按 Cmd+Shift+P,输入并运行 GistPad: Refresh Gists。