企业官网建设流程全解析

如何用 TY_MAX_PARALLELISM 限制 ty 的并行文件检查任务数？

【免费下载链接】tyAn extremely fast Python type checker and language server, written in Rust.项目地址: https://gitcode.com/GitHub_Trending/ty2/ty

ty 是一个用 Rust 编写的 Python 类型检查器。执行ty check检查项目时，ty 会并行执行检查任务，文档以“多少个文件并行被检查”作为任务并行度的示例。当你需要在资源受限的环境中压低 ty 的并行任务数时，可以使用环境变量TY_MAX_PARALLELISM设置一个上限。适用前提：已按 安装文档 装好 ty，并在一个能被ty check识别的 Python 项目目录下操作。

先确认 ty check 可以在你的项目中运行

限制并行度的操作本身不改变检查结果，所以先跑通一次基线检查，方便后续对比。

1. 确认 ty 可用，任选一种文档中的安装方式，例如全局安装：

uv tool install ty@latest

2. 在项目目录下运行检查：

ty check

不传路径参数时，ty check默认检查项目根目录下的所有 Python 文件（递归包含子目录）。如果你在项目里使用虚拟环境，可能需要先激活虚拟环境或用uv run调用 ty，以便它找到已安装的依赖。

3. 用退出码判断这次检查是否正常跑完（见 退出码文档）：

退出码为0或1都说明检查本身执行完成了；2和101表示运行出错，需要先解决。

设置 TY_MAX_PARALLELISM 限制并行任务数

环境变量文档对TY_MAX_PARALLELISM的定义是：指定 ty 允许并行运行的任务数上限，例如多少个文件并行被检查。文档同时强调这不是线程数上限——ty 在必要时仍可能创建额外线程，例如监听文件系统变化或专用 UI 线程。

在运行ty check的 shell 会话中设置该变量即可，示例值1仅为演示，请替换为你需要的上限：

# Bash / Zsh（Linux、macOS） export TY_MAX_PARALLELISM=1 ty check

如果只想对单次调用生效，不用export，把变量内联在命令前：

TY_MAX_PARALLELISM=1 ty check

Windows PowerShell 下写法为：

$env:TY_MAX_PARALLELISM = "1" ty check

两点边界说明，均来自环境变量文档：

• 该值是一个上限，不是固定并行数，ty 可以在不超过它的范围内调度任务；
• 它约束的是并行任务数，不约束线程总数，watch 文件系统变化等用途的额外线程不受此限制。

等价替代：RAYON_NUM_THREADS

同一份文档还定义了外部标准变量RAYON_NUM_THREADS：指定 ty 并行工作时的线程数上限，且与TY_MAX_PARALLELISM等价，它本身是 Rayon 的标准环境变量。如果你的工具链里已经习惯通过 Rayon 的标准变量来约束并行度，直接使用它即可：

RAYON_NUM_THREADS=1 ty check

如何验证限制生效后的运行情况

文档没有提供直接读取 ty 当前生效并行度数值的命令，所以验证分两层：

1. 检查是否照常跑完：运行ty check后查看退出码，0（无违规）或1（有违规）表示检查在限制下正常执行完毕；若出现2，先检查 CLI 选项、配置和 IO 问题。
2. 检查结果是否受影响：与设置限制前那次基线运行对比诊断输出。TY_MAX_PARALLELISM只影响任务的并行调度，不改变检查规则与严重级别配置，因此两次运行在同一代码上应得到一致的诊断结论。

限制

• TY_MAX_PARALLELISM只通过环境变量生效，文档未提供ty.toml中对应的配置项；
• 它不是线程上限，ty check --watch等场景下 ty 仍可能额外创建监听线程（见 类型检查文档中的 watch 模式说明）；
• 文档未给出推荐取值或性能收益数据，具体取多少需要你结合实际环境的资源情况自行确定。

如果日常开发更关心改完代码后尽快得到反馈，可以改用增量监听模式，它会只对受影响的文件重新检查：

ty check --watch

【免费下载链接】tyAn extremely fast Python type checker and language server, written in Rust.项目地址: https://gitcode.com/GitHub_Trending/ty2/ty