# @blueprintjs/tslint-config 中文文档

规范地址：https://npmcn.com/package/%40blueprintjs/tslint-config/

版本：4\.1\.9
npm 元数据更新时间：2026-01-06T20:57:41.143Z
中文译文更新时间：2026-11-08T08:53:27.484Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40blueprintjs/tslint-config
原文对照：https://npmcn.com/package/%40blueprintjs/tslint-config/?lang=original
项目主页：https://github.com/palantir/blueprint#readme
源码仓库：https://github.com/palantir/blueprint

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

- 包体积（解压后）：49.2 kB，21 个文件
- TypeScript 类型：未声明
- 运行依赖：4 个
- peer 依赖：tslint ^6\.0\.0
- 首次发布：2017-12-14T23:41:45.188Z
- 最新版本发布：2026-01-06T20:57:40.928Z
- 近 30 天下载量：2110（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 1 个）

## 中文简介

@ blueprintjs 包的 TSLint 配置

## 安装

```sh
npm install @blueprintjs/tslint-config
```

也可以使用：`pnpm add @blueprintjs/tslint-config`、`yarn add @blueprintjs/tslint-config`、`bun add @blueprintjs/tslint-config`

## README

![](https://cloud.githubusercontent.com/assets/464822/20228152/d3f36dc2-a804-11e6-80ff-51ada2d13ea7.png)

## 说明: 此套件的折旧为: `@blueprintjs/eslint-plugin`

[TSLint 已贬值](https://medium.com/palantir/tslint-in-2019-1a144c2317a9)因此,蓝图正在向ESLint过渡。 蓝图现在在自己的寄存器中使用ESLint,因此这个软件包将在未来的主要版本被去掉.

# [蓝图](http://blueprintjs.com/) [TSLint 图像](https://palantir.github.io/tslint) 配置

蓝图是网络的React UI工具包.

此软件包包含配置 [TSLint 图像](https://palantir.github.io/tslint) (TypeScript linter)和少数专门用于针对"蓝本"库开发的新规则.

**关键特性:**

-   React & JSX 规则来自 [tslint 反应](https://github.com/palantir/tslint-react)。 。 。 .
-   [高级](https://github.com/prettier/prettier) 为一致的代码样式和自动修正进行整合.
-   [蓝图特定规则](https://npmcn.com/package/%40blueprintjs/tslint-config/#readme-Rules) 用于: `@blueprintjs` 组件.

## 安装

```
pnpm add --save-dev @blueprintjs/tslint-config tslint
```

## 使用量

只需在您的 `tslint.json` 来使用默认规则配置。 这种配置包括实施特定语义的蓝图专用规则 `@blueprintjs` 软件包.

`tslint.json`

```json
{
    "extends": "@blueprintjs/tslint-config"
}
```

### 仅限规则使用

使《蓝图》具体规则成为可能 _仅限_ 没有完整的 DSLint 配置,请扩展 `blueprint-rules` 包内的配置 :

`tslint.json`

```diff
{
  "extends": [
+   "@blueprintjs/tslint-config/blueprint-rules"
  ]
}
```

### 编辑器集成

⭐️ **VS 代码 :** 启用 `tslint.autoFixOnSave` 选项,每次保存时都会修复所有可修复的失败.

## 规则

### `blueprint-classes-constants`

强制使用 `Classes` 常数在名称空格字符串上.

每个 `@blueprintjs` 软件包导出 a `Classes` 对象中包含由软件包定义的每个 CSS 类的常数。 虽然常数的值在释放之间可能会有变化,但常数的名称将保持更稳定.

```json
{
    "rules": {
        "blueprint-classes-constants": true
    }
}
```

```diff
-const element = <div className="pt-navbar" />;
+const element = <div className={Classes.NAVBAR} />;
```

### `blueprint-icon-components`

强制使用联合来文X `Icon` 组件结束 `IconName` 字符串正文( 或反文) 单位 `icon` JSX道具. 请注意,此规则仅支持在 `icon` pro;它不处理表达式或条件.

用于此规则的固定器将在字符串字元之间转换并命名 `Icon` 组件。 请注意,执行是天真的,可能需要干预,例如导入一个部件或固定一个无效的名称.

命名图标组件( E)`TickIcon`, (中文(简体) ), `GraphIcon`(a) 可从下列来源导入: `@blueprintjs/icons` 软件包.

此规则在 `blueprint-rules` 配置,因为确保 `@blueprintjs/icons` 软件包可以是树切(一种选入过程,需要使用组件和 _永远_ `IconName` 字义.

```js
{
  "rules": {
    // default uses "component"
    "blueprint-icon-components": true,
    // expanded syntax
    "blueprint-icon-components": {
      "options": ["component" | "literal"] // choose one
    }
  }
}
```

`"component"`

```diff
-<Button icon="tick" />
+<Button icon={<TickIcon />} />
```

`"literal"`

```diff
-<Button icon={<GraphIcon />} />
+<Button icon="graph" />
```

### [完整文档](http://blueprintjs.com/docs) | [源代码](https://github.com/palantir/blueprint)

## 常见问题

### @blueprintjs/tslint-config 是什么？

@ blueprintjs 包的 TSLint 配置

### 如何安装 @blueprintjs/tslint-config？

在项目目录运行 npm install @blueprintjs/tslint-config，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：tslint（^6\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @blueprintjs/tslint-config 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/blueprintjs\_\_tslint-config 是否存在。

### @blueprintjs/tslint-config 可以商用吗？

@blueprintjs/tslint-config 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @blueprintjs/tslint-config 的下载量有多少？

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

### @blueprintjs/tslint-config 还在维护吗？

最新版本 4\.1\.9 发布于 2026/01/07（10 个月前）；至今共发布 39 个版本，其中过去 12 个月发布了 1 个；首次发布于 2017/12/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。