应重新生成GitHub Personal Access Token并配置,或改用GitHub OAuth登录,必要时清除GistPad缓存并重装插件。

如果您希望在 Visual Studio Code 编辑器中直接创建、查看、编辑和同步 GitHub Gists,但发现插件未响应或无法登录 GitHub 账户,则可能是由于身份验证失败或本地令牌配置异常。以下是解决此问题的步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、重新生成并配置 GitHub Personal Access Token
GistPad 依赖 GitHub 的 Personal Access Token 进行身份验证,若令牌过期、权限不足或被撤销,插件将无法访问 Gists。需手动创建具备必要权限的新令牌,并在 VSCode 中更新配置。
1、访问 https://github.com/settings/tokens/new,登录 GitHub 账户。
2、在 Token description 字段中输入 gistpad-auth,勾选 gist 权限(仅需此项,无需 admin: gist 或其他扩展权限)。
3、点击 Generate token,复制生成的完整令牌字符串(以 ghp_ 开头)。
4、在 VSCode 中按下 Cmd + Shift + P(Mac)或 Ctrl + Shift + P(Windows/Linux),输入并选择 GistPad: Set GitHub Token。
5、在弹出的输入框中粘贴刚复制的令牌,按回车确认。
二、启用 GitHub OAuth 流(替代令牌方式)
GistPad 支持通过 GitHub 官方 OAuth 流完成授权,避免手动管理令牌,且自动处理刷新与作用域验证。该方式更安全,适用于启用了 SSO 或双因素认证的账户。
1、在 VSCode 命令面板中执行 GistPad: Login with GitHub。
2、VSCode 将打开系统默认浏览器,跳转至 GitHub 授权页面;确认允许 GistPad 访问您的 gists。
3、授权成功后,浏览器页面显示 Authentication successful — you can close this tab。
4、返回 VSCode,执行 GistPad: Refresh Gists,检查侧边栏是否列出您的公开与私有 Gists。
三、重置 GistPad 本地缓存与状态
插件本地缓存可能因版本升级或网络中断而损坏,导致 UI 不更新或列表为空。清除缓存可强制插件重建会话与元数据索引,不涉及 GitHub 端数据。
1、关闭当前所有 VSCode 窗口。
2、在终端中执行命令:rm -rf ~/.vscode/extensions/geddski.gistpad-*(Mac/Linux)或使用文件管理器删除 %USERPROFILE%\.vscode\extensions\geddski.gistpad-*(Windows)。
3、重新打开 VSCode,前往扩展市场搜索 GistPad 并重新安装最新稳定版。
4、安装完成后,**不要立即登录**,先重启 VSCode,再执行任一登录方式(Token 或 OAuth)。










