如何让python-lsp-server有效解析通配符导入的Python符号？

针对默认Jedi后端的配置调整 #

• 开启全范围符号扫描：在python-lsp-server配置中设置pylsp.plugins.jedi_symbols.all_scopes = true，让Jedi深度扫描导入模块的所有符号，而非仅部分可见符号。
• 关闭快速解析优化：设置pylsp.plugins.jedi.completion.fuzzy = false，强制Jedi执行精确的模块符号遍历，虽然会增加解析耗时，但能解决通配符导入的符号溯源问题。

切换到PyRight后端（更可靠的通配符解析） #

python-lsp-server支持PyRight作为替代分析后端，它对通配符导入的解析逻辑更完善：

• 启用PyRight：在配置中设置pylsp.plugins.pyright.enabled = true，同时禁用Jedi相关插件（如pylsp.plugins.jedi_symbols.enabled = false）。
• 调整分析模式：设置pylsp.plugins.pyright.typeCheckingMode = "basic"（或"strict"），确保PyRight对导入模块做完整的符号提取，即使模块未定义__all__也能扫描到所有公开符号。

辅助优化：规范模块的__all__定义 #

在被导入的模块（比如示例中的utils.py）中添加__all__列表，明确导出的符号：

# utils.py
__all__ = ["check_files_in_directory"]

def check_files_in_directory():
    pass

这不仅能让python-lsp-server快速识别通配符导入的符号，还符合Python代码规范，避免导入不必要的私有符号。

自定义扩展（按需使用） #

如果默认配置仍无法满足需求，可以编写简单的python-lsp-server插件：

1. 监听符号解析请求，识别代码中的通配符导入语句。
2. 手动扫描目标模块文件，提取所有非下划线开头的符号（或遵循模块的__all__定义）。
3. 将这些符号关联到当前模块的符号引用，完成溯源。

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