Visual Studio Code自定义函数输入点语法无自动补全提示配置咨询

常见漏配置项排查（按发生概率从高到低排序） #

• 包目录识别规则校验
  首先确认ws_functions包根目录下存在__init__.py文件（哪怕为空），否则IDE会将该目录判定为普通资源文件夹，不会扫描内部的函数作为可补全的模块成员。
  如果你把自定义函数拆分在包内的多个子py文件中，没有在__init__.py中做对外导出声明，也会导致补全失效。需要在__init__.py中补全挂载语句，把需要暴露的函数同步到包根命名空间，示例代码如下：

  # ws_functions/__init__.py 配置示例
  from .calculate import calc_tax, calc_bonus
  from .format import parse_str, format_date
  

• Python解释器路径匹配错误
  检查当前项目绑定的Python解释器，是否将ws_functions包所在的根目录添加到了PYTHONPATH检索路径下。如果是将ws_functions作为独立开发包使用，需要确认是在当前激活的项目虚拟环境中执行了可编辑安装，而不是把包装到了其他无关的环境里。
• 补全引擎配置遗漏
  如果使用VS Code搭配Pylance/Python语言服务，需要确认两个核心配置开关已开启：
  • 自动导入补全：python.analysis.autoImportCompletions
  • 函数补全带括号：python.analysis.completeFunctionParens
    要是配置已经正确还是没反应，直接重启一次Python语言服务刷新索引缓存，排除缓存失效的问题。
• 补全触发条件不满足
  自动弹提示的前提是，代码中已经完成ws_functions的导入（即已经写了import ws_functions语句），此时输入ws_functions.才会触发函数列表弹框；如果没写导入语句就输入点语法，是不会调出对应补全的。

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