SuperAPI AI 工具集

ty

编程与开发

查看项目

更新于 10-15 17:20

技能介绍

用途:ty 是极快的 Python 类型检查器与语言服务器,用于替代 mypy、Pyright 等类型检查工具。当项目 pyproject.toml 中存在 [tool.ty] 段或存在 ty.toml 配置文件时,应使用 ty 进行类型检查。

主要能力:支持对整个目录、指定文件或指定目录做类型检查;可配置规则级别(error、warn、ignore);可指定目标 Python 版本与平台;支持在 pyproject.toml 或 ty.toml 中配置环境、规则、源码包含/排除、终端输出格式,并支持按文件覆盖规则(如对 tests 放宽)。该插件会自动为 .py 和 .pyi 文件配置 ty 语言服务器。

使用方式:若 ty 是项目依赖,用 uv run ty ... 以使用锁定版本;若未作为依赖或仅做一次性检查,用 uvx ty ...。常用命令:ty check 检查当前目录全部文件;ty check path/to/file.py 检查指定文件;ty check src/ 检查指定目录。规则配置示例:ty check --error possibly-unresolved-reference、ty check --warn division-by-zero、ty check --ignore unresolved-import。版本与平台:ty check --python-version 3.12、ty check --python-platform linux。从 mypy 迁移:mypy . 对应 ty check,mypy --strict . 对应 ty check --error-on-warning。从 Pyright 迁移:pyright . 对应 ty check。

限制与约定:不要随意添加忽略注释,应优先修复类型错误;仅在用户明确要求时添加忽略,且使用 ty: ignore 而非 type: ignore,并尽量使用针对具体规则的忽略形式。详细文档见 https://docs.astral.sh/ty/。