应重新配置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。










