VS Code编写Python代码时自动补全仅显示破折号不展示补全选项

故障现象 #

• 编写Python代码触发自动补全时，弹出的补全列表中所有条目仅显示破折号，无法查看具体补全选项的文本内容
• 点击对应破折号条目可正常插入补全内容，补全功能逻辑本身运行正常，仅存在预览内容渲染异常
  

排查修复步骤 #

按顺序尝试以下操作，每步完成后测试补全是否恢复正常：

• 清理Python扩展缓存
  按下快捷键Ctrl+Shift+P（macOS系统替换为Cmd+Shift+P）调出命令面板，输入并执行Python: Clear Cache and Reload Window，等待窗口自动重载完成即可测试。
• 排查扩展版本兼容问题
  打开扩展侧边栏，找到官方Python和Pylance扩展：如果是刚更新完扩展出现的故障，点击扩展卡片上的下拉箭头，选择「安装其他版本」回退到上一个稳定版本后重载窗口；如果超过3个月未更新这两个扩展，直接升级到最新正式版后重载测试。
• 排查扩展冲突
  临时禁用除官方Python、Pylance之外的所有补全类、AI代码提示类、界面自定义类扩展，重载窗口测试。如果补全恢复正常，逐个重新启用扩展，定位到导致冲突的扩展后做禁用、降级处理即可。
• 校正补全界面配置
  打开设置面板，依次检查以下配置项：
  1. 搜索editor.suggest.showIcons，确保该配置为开启状态
  2. 搜索editor.suggestFontSize、editor.suggestLineHeight，如果之前手动设置过非默认值，清空配置值让其跟随编辑器全局字体、行高设置
  3. 如果安装过自定义VS Code界面样式的插件（比如Custom CSS and JS Loader），临时禁用所有自定义样式规则后重启测试，这类样式修改很容易导致补全列表文字渲染失败。
• 配置重置（终极方案）
  以上操作都无效时，打开命令面板执行Preferences: Open User Settings (JSON)，备份现有配置后，逐段注释自定义配置项排查错误规则，重点排查和编辑器渲染、补全弹窗相关的自定义配置。

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