Pylint误报全局函数未使用错误：函数被其他模块调用

针对你遇到的Pylint误报（函数被其他模块引入调用却被标记为未使用），可以用以下几种方法解决：

• 声明导出符号列表__all__
  在documentation.py文件的导入语句之后、函数定义之前，添加__all__列表，明确标记该函数是对外导出的接口。Pylint会识别这个列表，不再判定该函数为未使用。
  代码示例：

  from pathlib import Path
  
  __all__ = ["build_documentation"]
  
  def build_documentation(folder: Path):
      ...
  

• 添加针对性忽略注释
  直接在函数定义行末尾添加Pylint忽略注释，精准屏蔽该函数的unused-variable误报，不影响其他代码的检查。
  代码示例：

  def build_documentation(folder: Path):  # pylint: disable=unused-variable
      ...
  

• 修改Pylint配置文件
  如果项目中有大量这类跨模块导出的函数，可以通过配置文件批量调整规则。比如在项目根目录的.pylintrc文件中，针对特定模块禁用unused-variable检查：
  配置示例：

  [MESSAGES CONTROL]
  disable=
      builder.documentation:unused-variable
  

  注意：这种方式适合批量处理，若只是个别函数，前两种方法更精准。

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