Python运行脚本报NameError: name 'parse_config' is not defined如何解决

部署从GitHub获取的脚本集时，项目内utils.py包含如下代码：

p_dir = os.path.dirname(os.path.realpath(__file__)) + "/"
username = getpass.getuser()
myData = parse_config(p_dir+"../config/data.config")
myPars = parse_config(p_dir+"../config/parameters.config")
myPipelines = parse_config(p_dir+"../config/pipeline.config")

运行脚本时触发报错：

myData = parse_config(p_dir+"../config/data.config")
NameError: name 'parse_config' is not defined

初步判断为依赖未导入，手动导入configparser模块后报错仍存在，需要确认parse_config()函数所属模块，以及该类问题的通用修复方案。

parse_config 不属于Python标准库的内置函数，也不是configparser模块提供的顶层可直接调用方法，因此单独导入configparser无法解决问题。该报错的本质是当前运行上下文中找不到parse_config的定义，这个函数要么是项目自定义封装的配置解析工具函数，要么是项目依赖的第三方包内的方法，未提前定义或导入就会触发NameError。

按以下优先级逐一排查处理：

• 排查项目内自定义函数
  全局搜索项目所有代码文件，查找def parse_config(的函数定义。这类配置解析封装函数通常是项目作者自行编写的，一般存放在同目录工具文件、项目根目录下的common.py、专门的config工具模块中。找到对应定义位置后，在utils.py头部补全导入语句即可，例如函数存放在项目的utils/config_helper.py路径下时，添加如下导入：

  from utils.config_helper import parse_config
  

• 核对项目依赖清单
  查看项目根目录下的requirements.txt、pyproject.toml、setup.py等依赖声明文件，确认是否列出了包含parse_config方法的第三方依赖包。不少开源工具包会封装同名配置解析方法，按照依赖清单安装对应包后，补全对应导入语句即可。
• 补全缺失的函数实现
  如果全局搜索后确认项目漏提交了封装parse_config的文件，可以根据项目内config目录下的配置文件格式，自行补全函数实现。例如配置为ini格式时，可以基于标准库configparser实现最简版本：

  import configparser
  def parse_config(config_path):
      cfg = configparser.ConfigParser()
      cfg.read(config_path, encoding="utf-8")
      return cfg
  

  如果配置为yaml、json、hocon等其他格式，对应调整解析逻辑即可。
• 补全基础导入
  排查utils.py头部的基础导入，现有代码用到了os、getpass模块，需要确认这两个模块的导入语句存在，避免修复parse_config问题后触发其他同类报错：

  import os
  import getpass
  

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