PyCharm中**kwargs自动补全失效，用epytext语法@keyword无效求解决

我之前也碰到过类似的困扰，针对你用Epytext语法@keyword声明关键字参数但自动补全没生效的情况，试试下面这几个方案：

• 确保Epytext文档字符串格式完全正确
  PyCharm对Epytext的@keyword解析有严格的格式要求，必须搭配@type明确参数类型，否则可能无法识别。正确的示例应该是这样：

  def process_data(**kwargs):
      """
      处理输入数据的函数
      
      @keyword threshold: 过滤数据的阈值
      @type threshold: float
      @keyword log_level: 日志输出级别
      @type log_level: str
      """
      pass
  

  注意@keyword和对应的@type要一一对应，描述信息也要清晰，这样PyCharm才能准确提取参数信息。

• 验证文档字符串设置是否真正生效
  你提到已经修改了PyCharm的文档字符串格式，但有时候设置变更需要重启IDE才能生效。可以再走一遍确认流程：
  打开File > Settings > Tools > Python Integrated Tools，在Docstring format下拉框里确认选中的是Epytext，然后重启PyCharm，再测试自动补全功能。

• 用TypedDict增强kwargs的类型提示
  如果Epytext的方式还是不行，推荐结合TypedDict来定义kwargs的结构，这是PyCharm识别度更高的方式，补全效果也更稳定：

  from typing import TypedDict
  
  class ProcessKwargs(TypedDict):
      threshold: float
      log_level: str
  
  def process_data(**kwargs: ProcessKwargs):
      """
      处理输入数据的函数
      
      @keyword threshold: 过滤数据的阈值
      @keyword log_level: 日志输出级别
      """
      pass
  

  这样定义后，PyCharm会直接把threshold和log_level作为可选的关键字参数显示在自动补全列表里。

• 检查PyCharm版本是否过旧
  一些早期版本的PyCharm对Epytext的@keyword支持存在兼容性问题，建议升级到最新的稳定版（比如2024.x系列），新版本对文档字符串和类型提示的解析能力有明显提升。

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