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”命令重建文件索引。
