如何用 ty check --watch 在开发时增量监听类型变化【免费下载链接】tyAn extremely fast Python type checker and language server, written in Rust.项目地址: https://gitcode.com/GitHub_Trending/ty2/ty在开发 Python 项目时如果你希望每次保存代码后都能立刻知道类型是否被改坏反复手动执行ty check既繁琐又慢。tyAstral 出品的 Python 类型检查器提供了ty check --watch增量监听模式ty 会监视文件变化只对受影响的文件包括依赖了被改动文件的文件重新检查后续的增量检查比反复运行ty check快得多。本文基于 type-checking 文档 和 CLI 参考给出在开发过程中开启并确认该模式的完整操作路径。开始前确认环境与依赖可被发现--watch是ty check的一个选项短参数-W所以前提是能正常运行ty check。按 安装文档 任选一种方式取得 ty例如uvx ty check # 免安装快速试用 uv tool install tylatest # 用 uv 全局安装 pip install ty # 用 pip 装入当前环境然后确认两个环境前提来自 type-checking 文档在项目内运行时ty 从带pyproject.toml的目录作为项目根并对项目内所有 Python 文件递归子目录运行检查不在项目内时则对当前工作目录下所有 Python 文件运行。ty 需要发现已安装的包才能检查第三方依赖的用法。ty 会依次查找激活的虚拟环境VIRTUAL_ENV、项目根或工作目录下的.venv、PATH中的python3/python。文档特别提示在项目内你可能需要先uv run或激活虚拟环境ty 才能找到依赖。如果虚拟环境不在默认位置可用--python或--venv显式指定解释器或虚拟环境路径例如--python .venv/bin/python3。如果项目把代码放在非默认的app/等目录按 模块发现文档 在pyproject.toml中配置environment.root否则第一方模块可能发现不了。启动监听模式在项目根目录下或你想监听的目录执行ty check --watch也可以传具体路径只监听特定文件或目录例如ty check --watch example.py命令行为在 CLI 参考 中的定义是--watch-WWatch files for changes and recheck files related to the changed files。启动后命令不会退出而是持续监听文件一保存ty 就重新检查该文件以及依赖它的文件诊断信息直接输出到终端。为什么增量重查会很快language server 文档 一节Fine-grained incrementality说明ty 的增量更新发生在细粒度层面down to individual definitions只更新受影响的部分而不从头分析整个代码库。--watch模式正是复用这一机制来做后续检查。验证监听是否生效判断方法就是文档描述的行为本身编辑某个文件故意引入或修复一个类型错误保存。终端应随即对该文件及依赖它的文件输出新的诊断。如果错误消失说明修复已生效如果新增诊断说明你改坏了某处的类型。某条诊断不确定含义时用ty explain rule RULE查询该规则例如文档示例中出现的诊断 idinvalid-argument-type见 language-server 文档。想控制输出细节可配合ty check的现有选项--output-format支持full默认带上下文和提示、concise每条一行、gitlab、github、junit等格式--no-progress可隐藏进度条和 spinner。如果编辑保存后终端没有任何新诊断输出先检查上面一节的环境前提是否满足是否在项目根、依赖是否被发现、代码目录是否已配置environment.root并对照 exit codes 文档 理解退出码含义0表示没有warning及以上级别的违规1表示发现了违规2表示 CLI 选项无效、配置无效或 IO 错误101表示内部错误——退出码2通常意味着你的命令或配置本身有问题而不是类型检查的结果。限制与后续--watch是一个持续运行的前台监听进程文档没有提供后台/守护形式的用法不需要监听时直接结束该进程即可日常单次检查仍用不带--watch的ty check。若需要让 warning 级别的诊断也影响退出码例如后续接入 CI 脚本可组合--error-on-warning注意它不能与--exit-zero或--exit-zero-on-warning同时使用见 CLI 参考 与 exit codes 文档。进一步的规则配置--error/--warn/--ignore调整严重级别、包含与排除文件的持久配置分别在 rules 文档 和 exclusions 文档 中说明。【免费下载链接】tyAn extremely fast Python type checker and language server, written in Rust.项目地址: https://gitcode.com/GitHub_Trending/ty2/ty创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
