离线环境下VSCode需通过完整Python安装（含Lib目录）+正确配置python.defaultInterpreterPath，使Pylance自动读取标准库源码实现悬停文档与跳转；HTML离线文档需手动解压并用浏览器或Live Server插件打开。
离线环境下，VSCode 无法自动拉取 Python 官方文档（如 help()、悬停提示、Ctrl+Click 跳转到标准库源码），但可以通过本地文档镜像 + 手动配置实现等效效果。核心不是“装个插件就完事”，而是让 VSCode 的语言服务器（Pylance）和 Python 解释器能读到本地文档路径。
怎么让 Pylance 识别本地 Python 文档
Pylance 默认不联网查文档，但它依赖 Python 解释器的 pydoc 模块和标准库源码位置。离线时，只要解释器完整安装（含 Lib/ 目录），Pylance 就能生成基础悬停文档；但缺少交互式帮助（如 help(str.split)）和完整 API 索引。
- 确保离线机器上的 Python 是完整安装版（非 embeddable zip）——Windows 选
python-3.9.18-amd64.exe类安装包，Linux/macOS 用源码编译或pyenv install，避免只复制python.exe单文件 - 验证
Lib/目录存在且可读：python -c "import sys; print(sys.prefix)"→ 进入该路径下的Lib/，应有os.py、re.py等文件 - 在 VSCode 设置中确认
"python.defaultInterpreterPath"指向正确路径，否则 Pylance 会 fallback 到空文档 - 不要手动修改
"python.analysis.extraPaths"去加Lib/——Pylance 自动扫描，加了反而可能干扰解析
怎么离线使用 Python 官方 HTML 文档
官方文档官网（docs.python.org）的离线包是纯静态 HTML，VSCode 本身不直接集成，但可通过浏览器或外部工具调用。关键在于把文档解压后，用 VSCode 的 Open in Default Browser 或自定义命令打开。
- 从官网下载对应 Python 版本的离线文档 ZIP：
https://docs.python.org/3/download.html（例如python-docs-html-3.9.18.zip） - 解压到固定路径，如
C:python-docs.9index.html（Windows）或/opt/python-docs/3.9/index.html（Linux/macOS） - 在 VSCode 中按
Ctrl+Shift+P→ 输入Configure User Snippets→ 为python.json添加快捷片段："Open Python Docs": { "prefix": "pydoc", "body": [ "start ${env:SYSTEMROOT}\\System32\\cmd.exe /c start "" "C:\python-docs\3.9\index.html"" ] }（Linux/macOS 改用xdg-open或open） - 或者更简单：用
File → Open Folder打开解压后的文档目录，VSCode 内置静态服务器可预览（需启用liveServer插件，它支持离线安装）
为什么 Ctrl+Click 跳转到标准库失败
这不是文档问题，而是 Pylance 找不到源码路径。常见于 Python 安装时勾选了 “Add Python to PATH” 但没勾选 “Install for all users” 或 “Associate files”，导致注册表/符号链接缺失。
立即学习“Python免费学习笔记（深入）”；
- 检查
python -c "import os; print(os.__file__)"输出路径是否真实存在 —— 若报错或指向site-packages，说明标准库被覆盖或损坏 - Windows 下若用默认安装路径（
C:Users<user>AppDataLocalProgramsPythonPython39</user>），Pylance 可能因权限拒绝读取；建议重装到C:Python39并以管理员运行一次 VSCode 初始化 - Linux/macOS 用户注意：若用
pyenv，必须运行pyenv global 3.9.18后再启动 VSCode（不要从桌面图标直接启动，否则环境变量未加载） - 禁用
"python.analysis.typeCheckingMode"不会影响跳转，但关闭"python.languageServer"（即换用 Jedi）会导致跳转变慢且不准——离线环境强烈建议坚持用 Pylance
最易被忽略的一点：Pylance 的文档支持和跳转能力，高度依赖 Python 解释器自身的完整性，而不是 VSCode 插件数量。与其花时间找“离线文档插件”，不如花五分钟验证 python -m pydoc os.path.join 在终端里能否正常输出——如果终端都打不开，VSCode 里所有文档功能必然失效。
