Pyright单文件模式下自动补全失效问题分析与修复

在Python静态类型检查工具Pyright的最新版本1.1.378中，开发者发现了一个影响开发体验的重要问题：当以单文件模式运行时，代码自动补全功能完全失效。这个问题不仅影响了自动补全，还波及到了悬停提示等核心IDE功能。

问题现象 当开发者创建一个空的Python文件并启动Pyright的单文件模式后，所有基于语言服务器的智能功能都无法正常工作。通过对比Pyright 1.1.377和1.1.378版本的运行日志，可以明显观察到新版本中缺失了关键的自动补全响应。

技术分析 深入调查发现，问题的根源在于Pyright的WorkspaceFactory模块中关于工作空间密钥的处理逻辑发生了变化。具体表现为：

1. 默认工作空间被意外重建
2. 原始工作空间中的sourceFileInfo信息丢失
3. 后续请求无法定位到正确的源代码文件

核心差异出现在_getDefaultWorkspaceKey和_getWorkspaceKey这两个方法的实现上。在1.1.378版本中，这两个方法返回的工作空间密钥不一致，这很可能是由于Python路径处理逻辑的调整导致的。

影响范围 值得注意的是，这个问题仅出现在Pyright的独立运行模式中，在Pylance（基于Pyright的VSCode插件）中并未复现相同问题。这表明问题与特定的运行环境和初始化流程有关。

解决方案 开发团队迅速响应，通过修正工作空间密钥的生成逻辑，确保单文件模式下也能正确维护源代码文件信息。修复后的版本恢复了完整的语言服务器功能，包括：

• 代码自动补全
• 悬停提示
• 其他依赖源代码分析的智能功能

经验总结 这个案例展示了开发工具中一个常见但容易被忽视的问题：看似微小的底层逻辑变更可能对用户体验产生重大影响。特别是在处理工作空间和文件索引这类基础架构时，需要特别注意：

1. 保持不同模式下行为的一致性
2. 确保核心数据结构的稳定性
3. 进行全面的跨模式测试

对于Python开发者来说，当遇到IDE功能异常时，可以考虑检查工具版本，必要时回退到稳定版本，同时关注官方的问题追踪系统以获取最新修复信息。