Python如何给包添加命令行工具快捷指令_在entry_points中定义console

console_scripts必须写为entry_points={"console_scripts": ["name=package.module:func"]}或[project.entry-points."console_scripts"]下name = "package.module:func"，确保模块可导入、func是函数对象且包结构正确。

python如何给包添加命令行工具快捷指令_在entry_points中定义console_scripts

entry_points里console_scripts怎么写才生效

不写对格式，安装后 pip install -e . 也没法在终端直接敲命令。核心是：键必须是 console_scripts，值必须是 name=package.module:func 这种字符串列表，不能是字典、不能缩进、不能拼错冒号。

name 是你希望用户在终端输入的命令名，比如 mytool
package.module 必须是可 import 的路径（注意不是文件路径），且该模块得在 sys.path 里 —— 通常意味着它得在项目根目录或 src/ 下，并在 setup.py 或 pyproject.toml 中正确声明包结构
func 必须是函数对象，不能是字符串，也不能带括号；它最好接受 sys.argv[1:] 或用 argparse 解析参数
如果用 pyproject.toml，要写在 [project.entry-points."console_scripts"] 下，注意双引号不能省

setup.py 和 pyproject.toml 两种写法差异在哪

旧写法用 setup.py，新写法用 pyproject.toml，但底层都走 setuptools 的 entry point 机制。区别主要在配置位置和语法容错性：

setup.py：在 setup() 调用里传 entry_points={"console_scripts": ["mycmd=myapp.cli:main"]} —— 注意外层是字典，内层是字符串列表
pyproject.toml：必须用 TOML 表语法，写成 [project.entry-points."console_scripts"]，然后换行写 mycmd = "myapp.cli:main"；等号前后空格可选，但值必须是双引号包裹的字符串
如果同时存在 setup.py 和 pyproject.toml，现代 pip（≥21.3）优先读 pyproject.toml，setup.py 会被忽略 —— 别以为改了 setup.py 就生效

为什么装完命令找不到，或者报 ImportError

最常见原因不是 entry_points 写错，而是模块导入链断了。执行 mycmd 时，Python 实际是在新进程里做 import myapp.cli，所以任何 import 失败都会表现为 ModuleNotFoundError 或 ImportError。

361SCAN security check your skill python scripts

扫描并分析已安装技能，用于查看指定技能目录的名称、描述和详情，或列出所有已安装的技能。

下载

检查 myapp/__init__.py 是否缺失（尤其在 src/ 结构下，src/myapp/ 需配 packages=find_packages(where="src") 和 package_dir={"": "src"}）
运行 python -c "import myapp.cli; print(myapp.cli.main)" 看能否成功 import 并拿到函数对象
确认 myapp/cli.py 没有顶层代码触发异常（比如误写了 requests.get(...) 却没装 requests）
虚拟环境里装包后，别忘了关掉旧 shell 再新开一个——zsh/bash 的命令哈希缓存可能记着“没这个命令”

如何调试 console_scripts 生成的 wrapper 脚本

pip 安装时会在 venv/bin/（Linux/macOS）或 venv/Scripts/（Windows）下生成一个纯 Python 的 wrapper 脚本，名字就是你定义的 name。它不复杂，但能帮你定位问题。

用 which mycmd 找到脚本路径，直接 cat 或 less 查看内容，你会看到类似 from myapp.cli import main; main() 的调用
把里面那行 main() 改成 print("argv:", sys.argv); main()，再运行，就能确认参数是否透传进来
如果 wrapper 脚本根本没生成，说明 pip install 没识别到 entry_points —— 检查 pyproject.toml 的表头拼写，或 setup.py 是否被正确加载（比如用了 PEP 517 构建但没配 build-backend）