# 使用 Homebrew, apt 安装 west

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

## 安装

```sh
sudo av install brew:west
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install west
```

  证据: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install west
```

  证据: Debian stable package indexes: west from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

## 软件包事实

- **软件包键:** brew:west
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/west>
- **版本:** 1.5.0
- **来源摘要:** Zephyr meta-tool
- **主页:** <https://github.com/zephyrproject-rtos/west>
- **仓库:** <https://github.com/zephyrproject-rtos/west>
- **许可证:** Apache-2.0
- **源码归档:** <https://files.pythonhosted.org/packages/54/8e/ddb81e2635e58d156092556934a2cffe245978c91e4a08e11d72591f46e4/west-1.5.0.tar.gz>
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- west (cli)
- west (别名)

## 依赖

- libyaml
- python@3.14

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 1.5.0
- 本地数据: OK
- 上游仓库: https://github.com/zephyrproject-rtos/west
- 信息: No package-manager update timestamp was available.
- 信息: No cached GitHub release or tag data was available.
## 项目历史与用法

west is Zephyr's meta-tool: a Python CLI for managing Zephyr workspaces, multiple Git repositories, manifests, and common build, flash, debug, and extension workflows. The Zephyr documentation calls it a swiss-army-knife command line tool developed in its own repository.

### 项目历史

west was added because Zephyr needed two things at once: a standardized way to work with multiple Git repositories and an extensible command-line interface for basic Zephyr workflows. Zephyr's own history-and-motivation page explains that existing tools such as Git submodules and Google's Repo were examined but did not satisfy the project's requirements, including downstream overrides, Windows support, and commit-based or continuous project updating.

The GitHub repository was created in May 2018, and Zephyr 1.14-era release material introduced west for multiple-repository management plus improved flashing and debugging. That timing matches Zephyr's transition from a single RTOS repository mindset toward a modular embedded ecosystem with external modules, HALs, tools, samples, and downstream distributions.

west evolved through a pre-1.0 period where the tool's packaging and manifest APIs were still settling. Its v0.6 line removed the old split bootstrapper model and made core commands part of the PyPI-distributed package. West v1.0.0, published in February 2023, declared the APIs stable and dropped the compatibility modules needed by the old Zephyr 1.14 LTS line.

### 采用历史

west adoption is tied directly to Zephyr adoption: most Zephyr users encounter it during workspace setup. The standard flow is `west init` to create a workspace and clone the manifest repository, followed by `west update` to fetch the projects named in the manifest. Vendors and downstreams also use west manifests to pin Zephyr and module revisions for reproducible embedded products.

Because Zephyr is not just a kernel tree but a collection of code, modules, vendor HALs, and tools, west became the package-nerd-visible front door for many embedded developers. It is also extensible, so Zephyr can expose workflow commands such as build, flash, debug, and signing through the same top-level CLI.

### 使用方式

west workspaces contain a `.west` directory, a manifest repository, and multiple project repositories defined in a YAML manifest, usually `west.yml`. The command's core model is deterministic: the manifest repository's commits name exact or trackable revisions in project repositories, and `west update` makes the workspace match that manifest.

Typical users run `west init -m` with a Zephyr or downstream manifest, `west update` to clone modules, and Zephyr extension commands such as `west build`, `west flash`, or `west debug` during firmware work. Advanced users use `west manifest`, `west list`, `west forall`, `west compare`, and newer commands such as `west grep` to inspect or operate across a multi-repository workspace.

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

west is significant because it packages Zephyr's multi-repository source distribution into a single command-line mental model. For embedded developers, installing `west` is often the step that turns a pile of Git repositories into a coherent Zephyr SDK-style workspace.

### 时间线

- May 2018: zephyrproject-rtos/west repository is created.
- Zephyr 1.14 era: west is introduced for multiple repository management and enhanced flashing/debugging workflows.
- v0.6.x: west moves away from a split bootstrapper model and is distributed as one PyPI package.
- February 20, 2023: west v1.0.0 is published with stable APIs and no Zephyr 1.14 LTS compatibility modules.
- 2023-2025: later releases add workspace comparison, grep, aliases, manifest filtering, packaging updates, and auto-caching support.

### 来源

- <https://api.github.com/repos/zephyrproject-rtos/west>
- <https://api.github.com/repos/zephyrproject-rtos/west/releases?per_page=100>
- <https://docs.zephyrproject.org/latest/develop/west/basics.html>
- <https://docs.zephyrproject.org/latest/develop/west/index.html>
- <https://docs.zephyrproject.org/latest/develop/west/manifest.html>
- <https://docs.zephyrproject.org/latest/develop/west/release-notes.html>
- <https://docs.zephyrproject.org/latest/develop/west/why.html>
- <https://github.com/zephyrproject-rtos/west>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals


## 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

- Linux: /etc/westconfig, ~/.westconfig, $XDG_CONFIG_HOME/west/config, <workspace-topdir>/.west/config
- macOS: /usr/local/etc/westconfig, ~/.westconfig, <workspace-topdir>/.west/config
- Windows: %PROGRAMDATA%\west\config, %USERPROFILE%\.westconfig, <workspace-topdir>\.west\config
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** west
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## 其他软件包管理器记录

- Debian apt - west - 1.3.0-3: normalized package name match | Debian stable package indexes: west from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Zephyr RTOS Project meta-tool | https://github.com/zephyrproject-rtos/west


## 相关链接

- [Source-control packages](https://pkg.so/zh-hans/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/zh-hans/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://pkg.so/zh-hans/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [python@3.14](https://pkg.so/zh-hans/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [dtc](https://pkg.so/zh-hans/brew/dtc/) - Shares pkgdb curated category or tags: cli, developer-tools, embedded.
- [arduino-cli](https://pkg.so/zh-hans/brew/arduino-cli/) - Shares pkgdb curated category or tags: cli, developer-tools, embedded.
- [platformio](https://pkg.so/zh-hans/brew/platformio/) - Shares pkgdb curated category or tags: cli, developer-tools, embedded.
- [arm-none-eabi-gcc](https://pkg.so/zh-hans/brew/arm-none-eabi-gcc/) - Shares pkgdb curated category or tags: cli, developer-tools, embedded.
- [open-ocd](https://pkg.so/zh-hans/brew/open-ocd/) - Shares pkgdb curated category or tags: cli, developer-tools, embedded.
- [arm-none-eabi-binutils](https://pkg.so/zh-hans/brew/arm-none-eabi-binutils/) - Shares pkgdb curated category or tags: cli, developer-tools, embedded.
- [arm-none-eabi-gdb](https://pkg.so/zh-hans/brew/arm-none-eabi-gdb/) - Shares pkgdb curated category or tags: cli, developer-tools, embedded.
- [stlink](https://pkg.so/zh-hans/brew/stlink/) - Shares pkgdb curated category or tags: cli, developer-tools, embedded.
- [charm-tools](https://pkg.so/zh-hans/brew/charm-tools/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, libyaml, python.
- [cobo-cli](https://pkg.so/zh-hans/brew/cobo-cli/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, libyaml, python.
- [cookiecutter](https://pkg.so/zh-hans/brew/cookiecutter/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, libyaml, python.

## Combined YAML source

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


## 来源

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