如何让universal-ctags识别Python内置对象及Poetry管理的依赖？

一、添加Poetry依赖扫描路径 #

Poetry的依赖包存放在虚拟环境的site-packages目录下，先通过以下命令获取虚拟环境路径：

poetry env info --path

得到路径后，将其下的lib/pythonX.X/site-packages（替换X.X为你的Python版本，比如3.9）添加到ctags的扫描范围中。

方式1：命令行直接生成tags #

执行以下命令，同时扫描项目目录、依赖目录：

ctags -R . $(poetry env info --path)/lib/python3.9/site-packages

方式2：配置ctags永久生效 #

在用户根目录的~/.ctags或项目根目录的.ctags文件中添加以下内容：

--recurse=yes
--python-kinds=-i  # 忽略import语句，减少冗余标签
--exclude=.git
--exclude=__pycache__
# 添加Poetry依赖路径
--add-recurse=$(poetry env info --path)/lib/python3.9/site-packages

后续直接执行ctags -R .即可自动扫描依赖目录。

二、识别Python内置对象 #

Python标准库源码路径通常在/usr/lib/pythonX.X（Debian 11默认Python3.9对应/usr/lib/python3.9），将该路径加入ctags扫描范围即可识别内置对象（如join、choice、lru_cache等）。

命令行扩展扫描范围 #

ctags -R . $(poetry env info --path)/lib/python3.9/site-packages /usr/lib/python3.9

配置文件添加标准库路径 #

在.ctags中追加：

--add-recurse=/usr/lib/python3.9

三、Vim中配置标签跳转 #

确保Vim能找到生成的tags文件，在~/.vimrc中添加：

set tags=tags;  " 自动向上查找tags文件，适配多层目录结构
set autochdir   " 自动切换到当前文件所在目录

配置完成后，使用<C-]>即可跳转自定义对象、依赖库对象和Python内置对象。

注意事项 #

• 每次新增Poetry依赖后，需要重新执行ctags命令生成新的tags文件
• 若虚拟环境路径变更，需同步更新.ctags中的配置路径
• 可编写shell脚本自动化生成tags：

#!/bin/bash
POETRY_VENV=$(poetry env info --path)
PYTHON_STDLIB=/usr/lib/python3.9
ctags -R . "$POETRY_VENV/lib/python3.9/site-packages" "$PYTHON_STDLIB"

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