泰
发布: (2025年12月1日 GMT+8 05:30)
2 min read
原文: Hacker News
Source: Hacker News
入门
尝试使用 online playground,或通过 uvx 运行 ty 快速开始:
uvx ty
有关其他安装 ty 的方式,请参阅 installation 文档。
如果未提供子命令,ty 将列出可用命令——有关命令行选项的详细信息,请参阅 CLI reference。
使用 check 命令运行类型检查器:
uvx ty check
ty 将在工作目录及其子目录中的所有 Python 文件上运行。如果在项目中使用,它将对项目中的所有 Python 文件运行(从包含 pyproject.toml 的目录开始)。
你也可以提供特定路径进行检查:
uvx ty check example.py
在进行类型检查时,ty 会在活动虚拟环境(通过 VIRTUAL_ENV)中查找已安装的包,或在项目根目录或工作目录中发现名为 .venv 的虚拟环境。若未指定 --python 的目标路径,它不会在非虚拟环境中找到包。详情请参阅 module discovery 文档。
用法
在项目的顶层目录运行 ty check,使用 ty 的默认配置检查项目中的类型错误。如果这导致大量错误,并且你使用标准库的 venv 模块提供虚拟环境,请将 venv 目录添加到 .gitignore 或 .ignore 文件中,然后重新尝试。