如何让Python在虚拟工作区中实现单文件级别的补全与跳转功能？

问题本质 #

VS Code的Python语言服务（如Pylance）默认依赖工作区上下文提供智能特性，但虚拟/远程工作区中，若未将文件内容正确传递给语言服务，就只会保留基础语法高亮。JavaScript能正常工作，是因为其语言服务对单文件场景的兼容性设计更友好。

具体实现方案 #

• 同步文件内容到语言服务
  扩展构建虚拟工作区时，需确保打开的Python文件完整同步到VS Code文本模型，触发didOpenTextDocument事件让语言服务感知到文件存在。可通过vscode.workspace.openTextDocument创建虚拟文档，确保内容实时同步。

• 强制开启单文件分析模式
  在扩展中修改Python语言服务配置：通过vscode.workspace.getConfiguration('python')将python.analysis.diagnosticMode设为openFilesOnly，python.analysis.typeCheckingMode设为basic，让语言服务仅聚焦当前打开的文件，不依赖工作区其他配置。

• 模拟有效文件路径
  给虚拟Python文件分配临时本地路径（比如扩展临时目录下的同名映射文件），让语言服务识别为有效资源，避免因路径异常导致功能失效。

• 集成轻量单文件分析库
  若官方语言服务适配困难，可集成jedi这类轻量分析库，直接对当前文件文本做分析，自行实现补全、跳转定义的Provider，注册到VS Code扩展API中。这种方式完全脱离工作区依赖，只处理单文件内容。

验证步骤 #

1. 打开虚拟工作区的Python文件，检查语言服务初始化日志是否正常触发
2. 测试同文件内变量、函数的跳转，以及基础补全功能
3. 确认配置修改后未引入额外工作区依赖问题

内容的提问来源于stack exchange，提问作者eliphat