Python项目使用Versioneer执行install时报找不到_version.py文件错误

问题产生原因 #

• 配置的包目录路径不匹配：setup.cfg中填写的hw-assesment-tool目录不存在，或者名称拼写和实际项目中的包目录不一致（注意assesment是非标准拼写，标准写法为assessment，需核对你本地的实际目录名）。
• 命令执行路径错误：versioneer install必须在setup.cfg所在的项目根目录下执行，如果当前工作目录是子目录或者父目录，会导致路径解析错位，无法找到目标位置生成文件。
• 目录权限不足：当前运行命令的用户没有对hw-assesment-tool目录的写入权限，也会触发文件找不到的报错。

解决步骤 #

1. 核对项目目录结构
   在setup.cfg所在的目录下执行目录查看命令，确认存在同名的包目录，且目录内包含__init__.py文件（标识为Python包）。如果目录名拼写错误，直接修改setup.cfg中versionfile_source和versionfile_build的路径为实际的包目录名即可。
2. 校正命令执行路径
   执行路径查看命令确认当前工作目录就是setup.cfg所在的项目根目录，避免路径错位。
3. 手动预创建空文件（可选）
   如果确认路径无误仍报错，可以先手动创建空的目标文件：
   Linux/macOS执行：touch hw-assesment-tool/_version.py
   Windows直接在对应目录下新建空白文件命名为_version.py
   之后再重新执行versioneer install即可。
4. 验证安装结果
   安装无报错后，检查包目录下的__init__.py是否已自动添加版本导入代码from ._version import __version__，如果缺失可以手动补充。

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