VSCode中函数跳转不到Zeal，首要检查Zeal是否启动成功（右下角显示“Ready”）、50001端口是否被占用、vscode-zeal插件是否启用且端口配置为50001，并确认使用的是持续维护的princejwesley/vscode-zeal插件而非旧版dash兼容插件。
VSCode 里点函数跳转不到 Zeal？先确认通信通道通不通
Zeal 和 VSCode 之间不靠网络，但依赖本地 IPC 机制通信。默认走的是 http://localhost:50001 这个端口（Zeal 启动后自动监听），VSCode 插件通过它发搜索请求。如果跳转失败，90% 是这个端口被占、Zeal 没运行、或插件没配对。
检查步骤：
- 打开 Zeal，确认右下角状态栏显示 “Ready” —— 如果是 “Starting…” 或空白，说明没真正启动成功
- 终端执行
lsof -i :50001（macOS/Linux）或netstat -ano | findstr :50001（Windows），看端口是否被其他进程占用 - 在 VSCode 设置里搜
zeal，确认已启用zeal.enable，且zeal.port值是50001（不要改，除非你手动改过 Zeal 配置）
用什么插件？推荐 vscode-zeal 而不是 dash 兼容版
社区有多个 Zeal 集成插件，但只有 vscode-zeal（作者：princejwesley）持续维护、适配新 VSCode 版本，并正确处理中文文档集路径。旧的 dash 插件会把中文 docset 名里的空格或括号转义错，导致 Zeal 打开空白页。
安装要点：
- 必须在联网机器上装——插件本身不带 Zeal，只负责发请求；离线机只要 Zeal 已装好、docset 已下载即可
- 插件设置里
zeal.docset不用填，默认自动匹配；但如果你只装了Python和Bashdocset，它就只在这两个里搜，不会去翻React - 按住
Ctrl（Windows/Linux）或Cmd（macOS）再鼠标悬停函数名，会出现小浮层“? View in Zeal”，点击才触发跳转——不是悬停自动跳
跳转内容不准？和 docset 的命名与索引强相关
Zeal 查的是 docset 自带的 SQLite 索引文件（docSet.dsidx），不是全文扫描。如果搜 os.path.join 却跳到 C++ 的 std::path，大概率是 Python docset 没装全，或者装的是英文版却在搜中文关键词。
验证和修复方法：
- 打开 Zeal，左侧选中
Pythondocset，顶部搜索框直接输os.path.join—— 如果能出来，说明 docset 本身正常；搜不到，重装该 docset - 中文文档需用专门构建的中文 docset（如
Python-zh），不能指望英文 docset 支持中文搜索。官网zealdocs.org不提供中文包，得从第三方源（如github.com/zealuser/zh-docsets）下载并手动导入 - 手动导入路径：Zeal → Preferences → Docsets → + 号 → 选中解压后的
Python-zh.tgz或文件夹（注意不是 .tgz 内部的子目录）
快捷键失效或跳转慢？关掉 VSCode 的“预启用”机制
VSCode 1.85+ 默认启用 extensions.experimental.affinity，会让某些插件延迟加载。而 vscode-zeal 依赖实时响应，一旦被延迟，就会出现“点了没反应”或等 2 秒才弹出 Zeal 窗口。
解决方式（必须在 VSCode 设置 JSON 中手动加）：
"extensions.experimental.affinity": {
"princejwesley.vscode-zeal": 1
}
这个配置强制插件在启动时加载，不参与懒加载队列。值设为 1 表示最高优先级，0 是禁用（别设 0）。
另外，Zeal 窗口最小化后，首次跳转会唤醒并聚焦它；但如果 Zeal 被系统休眠或显卡驱动重置过，端口可能假死——此时只需关闭再重开 Zeal，不用重启 VSCode。
