vscode测试用例跳转失败主因是pytest配置、allure路径处理及语言服务索引未对齐：需禁用unittest、启用pytest并指定args，allure链接须url编码且注册协议，pylance需在pyproject.toml中include tests/路径。
VSCode 里点测试用例跳不到源码，不是跳转功能坏了，而是测试发现和导航链路没对齐——关键在 pytest 配置、Allure 报告注入、以及语言服务是否把 test_*.py 当作可索引的 Python 文件。
pytest 必须显式启用，且禁用 unittest
VSCode 默认同时扫描 unittest 和 pytest，但两者元数据冲突会导致测试文件不被识别，test_*.py 在测试资源管理器里直接消失。
- 在
settings.json中设"python.testing.unittestEnabled": false和"python.testing.pytestEnabled": true - 指定
"python.testing.pytestArgs": ["-s", "-v", "tests/"]，避免扫描整个项目根目录 - 改完后必须点击测试侧边栏右上角的刷新按钮，否则配置不生效
- 如果测试文件不在
tests/目录下，比如放在src/tests/，就得把路径写全：["-s", "-v", "src/tests/"]
Allure 报告里点击“Open in VSCode”没反应？检查协议注册和路径拼接
vscode://file/ 协议链接失效，90% 是路径没转义或系统未注册 handler。Allure 附件里生成的链接是纯文本，不会自动补全盘符或处理空格。
- 先手动在浏览器地址栏粘贴测试：
vscode://file/C:/project/tests/test_login.py:42，看是否能打开 —— 若无反应，说明 VSCode 没注册 URL 协议（Win/macOS 都需首次打开 VSCode 后重启浏览器） -
item.fspath返回的是py.path.local对象，直接拼进 URL 可能含空格或中文，建议用str(item.fspath)并urllib.parse.quote编码路径 - 行号
item.location[1]是从 0 开始的，但 VSCode 要求从 1 开始，需 +1 - 附件类型必须是
allure.attachment_type.URI_LIST，写成TEXT或漏掉_LIST后缀，链接会变成纯文本不可点击
跳转到测试函数定义失败？语言服务可能忽略 tests/ 目录
即使 pytest 跑起来了，Ctrl+Click 测试函数名仍跳不到定义，大概率是 Python 语言服务器（Pylance）没把 tests/ 视为源码根目录，导致符号未被索引。
- 检查 VSCode 右下角语言模式：确保当前
test_*.py文件右下角显示的是Python，不是Plain Text - 打开命令面板，运行
Python: Select Interpreter，确认选中了项目虚拟环境（非系统 Python） - 在项目根目录加
pyproject.toml，显式声明源码路径：[tool.pyright] include = ["src/", "tests/"]
- 若用
pylint或flake8，它们不影响跳转；但pyright或pylance的include配置直接影响符号索引范围
最易被忽略的一点：Allure 注入的链接只在测试失败时触发（因钩子判断 rep.failed），如果想让所有用例都带跳转链接，得去掉失败条件，但要注意路径有效性——未执行的测试项 item.location 可能为空，需加判空。
