基于pyproject.toml的可编辑安装下package entry points不生效问题咨询

修复方案 #

• 修正setup.cfg配置错误
  原配置中入口点配置段拼写错误，少了复数后缀s，pip会忽略无法识别的配置段，导致入口点脚本不生成。
  错误写法：

  [option.entry_points]
  

  修正后的完整正确配置：

  [options]
  package_dir =
      = package
  packages = .
  python_requires = >=3.6
  
  [options.entry_points]
  console_scripts =
      cons = scripts.cons
  
  gui_scripts =
      gui = scripts.gui
  

• 重新执行可编辑安装
  先卸载已安装的旧版本包，避免缓存影响：

  pip uninstall -y <你的包名>
  

  再重新执行安装命令：

  pip install -e .
  

  安装完成后可以执行以下命令确认入口点已被识别：

  pip show -f <你的包名>
  

  查看输出的Entry-points字段，确认cons、gui入口点存在即可。
• 验证路径配置
  1. 检查%LOCALAPPDATA%\Programs\Python\Python39\Scripts路径下已生成cons.exe、gui.exe或对应的.cmd启动脚本
  2. 确认%LOCALAPPDATA%\Programs\Python\Python39\Scripts已加入系统环境变量PATH，否则直接输入命令无法被系统识别
  3. 如果你使用了Python虚拟环境，入口点会生成在虚拟环境目录下的Scripts文件夹中，而非全局Python路径

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