---
url: /docs/guide/usage/linter/rules/jsdoc/check-access.md
---

### 它的作用

检查 `@access` 标签是否使用以下值之一：

* "package"、"private"、"protected"、"public"

此外还会报告：

* 在同一个文档块中将 `@access` 与 `@public`、`@private`、`@protected` 或 `@package` 混用。
* 在同一个文档块中使用多个 `@access`（或 `@public` 等）实例。

### 这为什么不好？

在 JSDoc 注释中保持一种一致的方式来指定访问级别非常重要。使用无效的访问级别标签或多个访问级别标签会让人对文档元素预期的可见性产生混淆，并可能导致 API 文档生成中的不一致。混用不同的访问标签或使用无效值会使文档变得不清晰，并可能具有误导性。

### 示例

以下是此规则的**错误**代码示例：

```javascript
/** @access private @public */

/** @access invalidlevel */
```

以下是此规则的**正确**代码示例：

```javascript
/** @access private */

/** @private */
```

## 如何使用

## 版本

此规则在 v0.2.16 中添加。

## 参考资料