dash在vscode离线环境不可用，因其插件仅支持macos、自2021年起停更且不兼容vscode 1.70+，而zeal+vscode-zeal插件跨平台、持续维护、完全离线可用。
离线状态下 VSCode 无法直接使用 Dash（macOS 专属），因为 Dash 是 macOS 应用，且其 VSCode 集成插件已基本停更、不兼容新版本；你真正能用的替代方案是 Zeal + vscode-zeal 插件——它跨平台、持续维护、支持中文 docset，且完全离线可用。
为什么 Dash 在 VSCode 离线环境里走不通
Dash 的 VSCode 插件（如 dash-vscode）依赖 Dash 的本地 HTTP 服务（http://localhost:8080），但该服务仅在 macOS 上运行，Windows/Linux 无对应进程；更重要的是，该插件自 2021 年起停止更新，VSCode 1.70+ 后频繁出现 Cannot read property 'webview' of undefined 错误，点击“View in Dash”后静默失败，控制台无提示，排查成本高。
- Dash 本身不支持 Windows/Linux，所以所谓“离线 Dash 集成”在非 macOS 系统上根本不存在
- 即使在 macOS 上，Dash 的 docset 路径含空格或中文时，旧插件会错误转义 URL（如把
Python 3.11变成Python%203.11再多加一层编码），导致 Zeal/Dash 打开空白页 - Dash 插件不读取
dash.docsetPath配置，而是硬编码查找~/Documents/Dash/DocSets，离线部署时若 docset 放在其他位置（如网络共享盘），它直接找不到
用 Zeal + vscode-zeal 实现等效离线文档跳转
Zeal 是 Dash 的开源跨平台替代品，UI 和 docset 格式完全兼容；vscode-zeal（作者 princejwesley）是目前唯一适配 VSCode 1.80+ 的活跃插件，支持中文路径、自动 docset 匹配、Ctrl/Cmd 悬停触发。
- 先在离线机装好 Zeal（官网下载 .dmg/.exe/.AppImage），启动后右下角必须显示
Ready，否则通信链路断开 - 确认 Zeal 监听端口是
50001（默认）：macOS/Linux 运行lsof -i :50001，Windows 运行netstat -ano | findstr :50001，确保没被 Python 进程或 Docker 占用 - VSCode 设置中搜
zeal.enable，设为true；zeal.port必须是50001（不要改，除非你手动改过 Zeal 配置） -
zeal.docset留空即可——插件会根据光标所在语言自动匹配已安装 docset（比如光标在print()上，就只查 Python docset；在git add上，就查 Git docset）
离线安装 vscode-zeal 插件的关键细节
插件本身不带 Zeal，只负责发 HTTP 请求；离线安装只需一个 .vsix 文件，但容易因版本或策略卡住。
- 必须从有网机器获取正确
.vsix：打开https://marketplace.visualstudio.com/items?itemName=princejwesley.vscode-zeal→ 点右下角Download Extension（不是 GitHub Release 页面的 zip） - Windows 下安装命令必须加双引号包裹路径：
code --install-extension "C:\vsix\vscode-zeal-0.7.2.vsix"，否则路径含空格时报ENOENT - 如果公司策略禁用扩展安装，状态栏会显示
Extensions disabled by policy，此时拖拽.vsix到编辑区也无效，需联系 IT 解除组策略限制 - 装完重启 VSCode，按住
Ctrl（Windows/Linux）或Cmd（macOS）悬停函数名，出现? View in Zeal浮层才算通路正常
真正卡住人的从来不是“怎么连”，而是 Zeal 启动后状态栏没变 Ready，或者端口被占却没意识到——这两点不验证，后面所有配置都是白忙。
