使用Hatch搭建Python CLI时遇“new-cli: command not found”错误求助

你的问题核心是Hatch默认环境未安装本地项目包，导致脚本无法找到对应的Python模块。以下是两种直接的解决方式：

方式一：临时安装本地包到默认环境 #

在项目根目录（new-cli文件夹下）执行以下命令，先以编辑模式安装本地包：

hatch run pip install -e .

安装完成后再运行你的CLI命令：

hatch run new-cli

方式二：配置默认环境自动安装本地包 #

修改项目根目录的pyproject.toml文件，给默认环境添加本地包依赖：

[tool.hatch.envs.default]
dependencies = ["-e ."]

保存文件后，直接执行hatch run new-cli即可正常运行。

补充说明 #

Hatch自动生成的[tool.hatch.envs.default.scripts]配置只是把new-cli命令映射到new_cli.cli:new_cli函数，但如果环境里没有安装new_cli包，Python就找不到这个函数，最终导致系统提示"command not found"。安装本地包后，环境就能识别到对应的模块和函数，命令即可正常执行。

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