# @codacy/tools-bandit-1 中文文档

规范地址：https://npmcn.com/package/%40codacy/tools-bandit-1/

版本：0\.28\.0
npm 元数据更新时间：2026-11-09T13:46:16.253Z
中文译文更新时间：2026-11-10T05:40:55.910Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40codacy/tools-bandit-1
原文对照：https://npmcn.com/package/%40codacy/tools-bandit-1/?lang=original
项目主页：https://github.com/codacy/analysis-cli
源码仓库：https://github.com/codacy/analysis-cli

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：44.8 kB，7 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：1 个
- 首次发布：2026-03-24T13:15:53.239Z
- 最新版本发布：2026-11-09T13:46:15.894Z
- 近 30 天下载量：11879（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：36（近 12 个月 36 个）

## 中文简介

强盗适配器——CLI-mode Python安全接通

## 安装

```sh
npm install @codacy/tools-bandit-1
```

也可以使用：`pnpm add @codacy/tools-bandit-1`、`yarn add @codacy/tools-bandit-1`、`bun add @codacy/tools-bandit-1`

## README

# 校对:soup

## 目录

-   [概览](https://npmcn.com/package/%40codacy/tools-bandit-1/#readme-overview)
-   [更新图案](https://npmcn.com/package/%40codacy/tools-bandit-1/#readme-updating-patterns)
-   [更新盗版](https://npmcn.com/package/%40codacy/tools-bandit-1/#readme-updating-the-bandit-version)
-   [发展](https://npmcn.com/package/%40codacy/tools-bandit-1/#readme-development)
-   [维护者的注释](https://npmcn.com/package/%40codacy/tools-bandit-1/#readme-notes-for-maintainers)

* * *

## 概览

使用 Python 安全插件 [强盗](https://bandit.readthedocs.io/) 二进制. 使用CLI执行战略 -- -- 产卵 `bandit` 从管理中的 Python venv 从 `spawnTool()` 并分析它的 JSON 输出.

| 财产 | 数值 |
| --- | --- |
| 工具标识 | `Bandit` |
| 编码 UUID | `89b6fc6a-9137-4cf3-8b9f-dcc3bedfa738` |
| 战略 | 国 际 |
| 语文 | 蟒 |
| 二进制 | `bandit` (中文(简体) ) |
| 文件图案 | `**/*.py` |

## 更新图案

```bash
# Re-fetch pattern metadata from the Codacy API
pnpm prefetch

# Commit the result
git add src/patterns.json
```

模式 ID 遵循格式 `Bandit_B602`, (中文(简体) ), `Bandit_B301`等 (中文(简体) ).

## 更新盗版

1.  更新 `preferredVersion` 内 `src/adapter.ts`
2.  更新 `PIP_PACKAGES` 带有新被绑定版本的阵列
3.  运行 `pnpm prefetch` 以检查新的/撤消的规则
4.  运行 `pnpm test` 以验证兼容性
5.  如果主要版本更改,请创建新的适配软件包(`bandit-2/`(中文(简体) )

## 发展

```bash
pnpm build    # Build with tsup
pnpm test     # Run tests (requires bandit in PATH or venv)
```

在当地安装用于测试的强盗:

```bash
pip install bandit==1.8.3
```

## 维护者的注释

-   **预设绘图`src/pattern-mappings.json`(中文(简体) )**:78张支票中有18张是门上的 检测到PyPI的依赖性,因为他们只向一个库的API开火. 10个 默认操作,现在不要使用不声明库的回购 `B201` (弗拉克语), `B701` (静嘉二), `B702` (马科语), `B601` (帕拉米科语), `B320`编号 :`B410` (lxml), (英语), `B506` (PyYAML), (英语:, `B113`编号 :`B501` (请求)和 `B308` (干戈语). 8起违约,现已可达 完全没有: `B610`编号 :`B611`编号 :`B703` (Django SQLi/XSS), (中文(简体) ), `B507` (帕拉米科主机密钥), `B508`编号 :`B509` (中文(简体) ), `B413`编号 :`B414` (PyCrypto vs. PyCryptodome—— 单独的项目,所以分开) 实体)。 故意左传:stdlib检查(`B301`– 说吧 –`B307`, (中文(简体) ), `B324`和 `B412`, (中文(简体) ), 其 httpoxy CGI 处理器无法读取 .
    
    其中两个需要第二个钥匙 因为Gating从 **直接** 只声明:
    
    -   `B701` 索赔人 `flask` 以及 `jinja2`. Flask 硬性依赖于 Jinja2 (单位:千美元)`Flask` → `jinja2>=3.1.2`)),所以真正的"Flask"应用通常从不列出Jinja2本身,并且 欢呼吧 `jinja2` 单从大多数Flask回放中 放弃了高度自动逃生检查.
    -   `B501` 索赔人 `httpx` 以及 `requests`强盗自己 `crypto_request_no_cert_validation` 插件检查两个库, 所以只检查 httpx repo 否则会失去 `verify=False` 检查.
    
    其中三道门是惰性的 **故意还是留着**数字 : `B320`, (中文(简体) ), `B410` (lxml) 和 (lxml) 和 `B414` (pycryptodome)仍然在科达西的图案目录中,但"盗匪"已经不再存在1.8.3 登记支票,让他们永远不能开火`blacklists/calls.py`:"滑倒了B320作为 请检查lxml.etree的呼叫已被删除" ; `blacklists/imports.py`: 对 `B410`· ; `B414` 仅仅是缺席 `gen_blacklist()`) (中文(简体) ). `mapping-drift.test.ts` 无法看见 这个——它比较了科达西的目录,而不是被安装的工具. 丢弃绘图 将三种默认的高/安全模式再次普遍化并写入每个 Python Repo的相貌,所以大门是小于邪恶的,直到目录赶上. 见 `docs/tech-debt.md`。 。 。 .
    
-   土匪需要Python 3作为跑步时间. 适配器使用孤立的阴道 `~/.codacy/runtimes/bandit-1/venv/`。 。 。 .
    
-   退出代码0=无发现,1=发现(正常), >1=出错.
    
-   `col_offset` 在"盗版"中输出为0;适配器为"1""问题"模型添加了1.
    
-   强盗 `issue_confidence` (LOW/MEDIUM/HH)关于该问题的地图至数字置信度(1/2/3).
    
-   CWE 信息来自 `issue_cwe` 随函附上问题信息如下: `(CWE-{id})`。 。 。 .
    
-   配置文件检测支持 `.bandit` (INI,通过与 `--ini`, (中文(简体) ), `bandit.yml` (YAML,通过与 `-c`),以及 `pyproject.toml` (TOML,通过 `-c`) (中文(简体) ).
    
-   模式过滤使用 `-t` 将逗号分离的测试ID传递给强盗.
    
-   这个 `errors` 匪帮 JSON 输出中的数组( 文件级错误, 如语法错误) 被映射到 `AnalysisError` 对象带有“警告”级别.

## 常见问题

### @codacy/tools-bandit-1 是什么？

强盗适配器——CLI-mode Python安全接通

### 如何安装 @codacy/tools-bandit-1？

在项目目录运行 npm install @codacy/tools-bandit-1，或使用 pnpm add / yarn add / bun add。

### @codacy/tools-bandit-1 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @codacy/tools-bandit-1 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @codacy/tools-bandit-1 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @codacy/tools-bandit-1 可以商用吗？

@codacy/tools-bandit-1 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @codacy/tools-bandit-1 的下载量有多少？

根据 npm 官方下载统计，@codacy/tools-bandit-1 在 2026/10/10 – 2026/11/08 这 30 天内被下载 11,879 次，日均约 396 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @codacy/tools-bandit-1 还在维护吗？

最新版本 0\.28\.0 发布于 2026/11/09（今天）；至今共发布 36 个版本，其中过去 12 个月发布了 36 个；首次发布于 2026/03/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。