# Role
> 返回给定站点的 Role 对象。
- 官方英文原文：https://gohugo.io/methods/site/role/
- 本页规范地址：https://hugozh.cn/methods/site/role/
- 最近更新：2026-10-02
- 最后提交：912b1d3 chore(site): 添加 static/CNAME（hugozh.cn），供 GitHub Pages 等平台绑定自定义域名
- 签名：SITE.Role
- 返回类型：roles.Role
- 站点：Hugo 中文文档（https://hugozh.cn/）· 社区维护的非官方中文翻译，如有出入以官方英文原文为准

---
**（0.153.0 新增）**

## 概述

`Site` 对象上的 `Role` 方法返回给定站点的 `Role` 对象，其内容来自项目配置中的角色定义。

## 方法

在 `Role` 对象上使用这些方法。

`IsDefault`
: （`bool`）报告这是否为[默认角色](g)。

  ```go-html-template
  {{ .Site.Role.IsDefault }} → true
  ```

`Name`
: （`string`）返回角色名称，即项目配置中转为小写的键名。

  ```go-html-template
  {{ .Site.Role.Name }} → guest
  ```

