GistPad 在 vscode 中需手动安装启用、配置带 gist 权限的gitHub PAT 令牌、通过命令面板操作、手动同步更新、并显式切换多文件 Gist 视图。
如果您希望在 VSCode 中直接创建、编辑、同步和分享github Gists，但发现 GistPad 扩展未按预期工作或功能不可用，则可能是由于扩展未正确配置、认证失败或权限不足所致。以下是解决此问题的步骤：
本文运行环境：macBook air，macOS Sequoia。
一、安装并启用 GistPad 扩展
GistPad 需作为第三方扩展手动安装，且必须启用后才能调用核心功能。该扩展依赖 VSCode 的扩展宿主环境与 GitHub API 通信能力。
1、打开 VSCode，点击左侧活动栏的扩展图标（方块拼图形状）。
2、在扩展市场搜索框中输入 GistPad，找到由hoovercj 发布的官方扩展。
3、点击“安装”按钮，等待状态变为“已启用”或手动点击“启用”。
二、完成 GitHub 个人访问令牌（PAT）配置
GistPad 不支持 OAuth 登录流程，必须使用 GitHub 生成的 Personal access Token进行身份验证，且该令牌需具备 gist 作用域 权限，否则无法读写 Gist 资源。
1、访问 GitHub Tokens 页面，勾选gist 权限项，其他权限保持默认不勾选。
2、点击“Generate token”生成令牌，并立即复制其完整 字符串 （以ghp_ 开头）。
3、在 VSCode 中按下Cmd+Shift+P（macos）调出命令面板，输入并选择“GistPad: Set GitHub Token”。
4、粘贴刚复制的令牌，按回车确认保存。
三、通过命令面板触发 Gist 操作
GistPad 不提供固定 ui 面板，所有功能均通过 VSCode 命令面板调用，需确保快捷键或命令名称准确无误，避免因大小写或空格错误导致命令不可见。
1、按下 Cmd+Shift+P 打开命令面板。
2、输入 GistPad: Create New Gist 并回车，系统将提示选择公开或私有类型。
3、选择文件后缀（如 .py 或.md），输入描述标题，确认提交即完成创建。
4、已存在 Gist 可通过“GistPad: List My Gists”命令拉取列表，再用方向键选择并回车打开。
四、修复 Gist 内容不同步问题
GistPad 默认不自动轮询更新，本地编辑后的变更需手动执行同步操作，否则 GitHub 端与 VSCode 端内容将出现偏差。
1、在已打开的 Gist 文件编辑器中，右键空白处，选择“GistPad: Update Gist”。
2、若提示“Failed to update gist”，检查当前文件是否已绑定有效 Gist ID（URL 中含 gist.github.com/ 及 16 位 ID）。
3、如需强制重载远程版本，执行“GistPad: Refresh Gist”命令，丢弃本地未提交修改并覆盖为 GitHub 最新快照。
五、处理 GistPad 无法识别多文件 Gist 的情况
GitHub 原生支持单 Gist 包含多个文件，但 GistPad 在旧版本中仅默认加载首个文件；若 Gist 含多个文件（如 script.js 与README.md），需显式切换视图。
1、打开 Gist 后，在 VSCode 底部状态栏查找以 Gist: 开头的区域。
2、点击该区域，弹出文件列表下拉菜单，从中选择目标文件名。
3、若列表为空，执行“GistPad: Reload Gist Files”命令重建文件索引。
