venv虚拟环境通过pip安装包后执行命令提示command not found

• 虚拟环境实际未激活：执行source venv/bin/activate时如果相对路径不对，或者shell配置拦截了激活脚本的环境变量修改，会出现激活假象——终端可能显示(venv)前缀，但$VIRTUAL_ENV变量为空、PATH也没实际注入venv/bin路径。
• 可执行文件缺失或权限异常：项目打包配置错误时，pip install -e .不会生成对应命令的入口脚本；就算生成了脚本，如果没有可执行权限，shell同样会判定为命令不存在。
• PATH配置被覆盖：激活虚拟环境后如果又执行了修改PATH的操作（比如加载了其他shell配置、切了conda环境），venv/bin路径会被挤到PATH后面甚至被移除，shell会优先找到其他位置的同名命令或者直接找不到。
• 命令调用方式错误：在命令前直接加python3前缀的排查方式本身就是错的——这种写法是让python3运行当前目录下同名的脚本文件，不是调用虚拟环境里安装的命令入口。

按顺序操作即可定位问题：

1. 确认虚拟环境真实激活
   执行echo $VIRTUAL_ENV，如果输出为空，先cd到venv文件夹所在的父目录，重新执行source ./venv/bin/activate，激活成功后再执行which 你要运行的命令名，正常应该返回venv/bin目录下的对应文件路径。
2. 校验入口文件状态
   执行ls -l ./venv/bin/ | grep 你的命令名，先确认文件是否存在：
   • 如果不存在：检查项目根目录下的pyproject.toml或setup.py，确认入口配置正确，比如pyproject.toml的入口配置格式如下：

     [project.scripts]
     你的命令名 = "你的包名.对应模块:入口函数名"
     

     修正配置后重新执行pip install -e .重装即可。
   • 如果存在但没有x权限位：执行chmod +x ./venv/bin/你的命令名添加可执行权限。
3. 校验PATH有效性
   激活环境后执行echo $PATH，确认venv/bin的绝对路径在PATH的最靠前位置，如果没有，手动执行export PATH="$(pwd)/venv/bin:$PATH"注入路径后再试。
4. 绕过PATH直接验证
   直接用绝对路径执行命令：./venv/bin/你的命令名，如果能正常运行，就是PATH配置问题；如果提示模块导入错误，回到第二步检查入口配置里的模块、函数路径是否写对。
   要用python方式调用的话，正确写法是python3 -m 你的包名.对应模块，不是直接在命令前加python3前缀。

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