# 使用 Homebrew, Nix 安装 zuban

查看 zuban 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:zuban
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install zuban
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#zuban
```

  证据: nixpkgs package indexes: pkgs/by-name/zu/zuban/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:zuban
- **软件包管理器:** Homebrew
- **版本:** 0.9.1
- **来源摘要:** Python language server and type checker, written in Rust
- **主页:** <https://zubanls.com/>
- **仓库:** <https://github.com/zubanls/zuban>
- **最后更新:** 2026-08-01T02:38:07Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- zmypy (别名)
- zuban (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 0.9.1
## 项目历史与用法

Zuban is a Python type checker and Language Server Protocol implementation written in Rust by David Halter, the creator of Jedi. It aims to combine mypy-compatible checking with a fast Python language server.

### 项目历史

The ZubanLS homepage frames the project as a successor to lessons learned from Jedi. Halter says he created Jedi in 2012, then started over in 2020 to build ZubanLS in Rust after concluding that Jedi's architecture could not provide the performance needed for large projects.

Zuban became an open-source developer tool with a CLI and language server. Its README describes a high-performance Python language server and type checker, supporting diagnostics, completions, goto, references, rename, hover, document highlights, a Pyright-like default mode, and a mypy-compatible mode.

The documentation and changelog show rapid maturation through the 2025 beta and 2026 releases, especially around editor integration, sys.path handling, Django support, typed Python conformance, and mode selection between default and mypy-compatible behavior.

### 采用历史

Zuban's adoption niche is emerging rather than settled: it enters a crowded Python static-analysis field that includes mypy, Pyright/Pylance, basedpyright, ty, Pyrefly, Jedi, and editor-specific integrations. Its practical pitch is speed plus compatibility rather than a new type system.

The package is designed for developer workstations and editors. The docs cover installation with pip, direct use as zuban check or zuban mypy, the zmypy alias, and configuration for VSCode, Vim, Neovim, Helix, Zed, Emacs, Kate, and Sublime Text.

### 使用方式

Command-line users run zuban check for the default mode, zuban mypy or zmypy for mypy-compatible behavior, and zuban server for LSP integration. Configuration is read from pyproject.toml and mypy.ini, including [tool.zuban], [tool.mypy], mypy_path, and many mypy-compatible options.

Editor users configure the zuban or zubanls command as a Python language server. The docs describe LSP initialization options such as typeCheckingMode, disableLanguageServices, diagnosticMode, and pythonExecutable.

### 为什么软件包爱好者会关心

Zuban is package-nerd significant because it shows the current packaging shape of Python tooling: a Rust implementation shipped as a Python-installable command, exposing both CLI and editor-server workflows, while reading existing Python project config files.

It also represents the modern pressure on language tooling packages to be drop-in enough for existing mypy users while fast enough to compete with native editor language servers.

### 时间线

- 2012: David Halter created Jedi, the project ZubanLS explicitly cites as its predecessor experience.
- 2020: Halter began building ZubanLS from the ground up in Rust.
- 2025-10-10: Zuban 0.1.0 beta release recorded in the changelog.
- 2026-04-06: Zuban 0.7.0 changed default/mypy mode behavior and improved Django and LSP support.
- 2026-06-23: Zuban 0.9.0 changelog entry records mode-selection fixes and additional mypy-compatible options.

### Related projects

- Related projects include Jedi, mypy, Pyright, Pylance, basedpyright, ty, Pyrefly, typeshed, Python LSP clients, VSCode, Neovim, Helix, Zed, Emacs, Kate, and Sublime Text.

### 来源

- <https://docs.zubanls.com/en/latest/>
- <https://docs.zubanls.com/en/latest/changelog.html>
- <https://docs.zubanls.com/en/latest/installation.html>
- <https://docs.zubanls.com/en/latest/usage.html>
- <https://github.com/zubanls/zuban>
- <https://raw.githubusercontent.com/zubanls/zuban/master/README.md>
- <https://zubanls.com/>


## 安全说明

broad file, network, media, or database tool signal.

- **Geiger 风险:** blue / 中
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: pyproject.toml, mypy.ini
## 其他软件包管理器记录

- Nix - zuban: normalized package name match | nixpkgs package indexes: pkgs/by-name/zu/zuban/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/zuban.yml](https://github.com/mxcl/pkgdb/blob/main/combined/zuban.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph