---
navTitle: $file
---
# $file - 当前文件对象

`$file`代表当前文件对象，在表达式中可以通过`$file.xxx`的形式来获取文件属性，有如下属性：

- `$file.id` - 元数据ID。
- `$file.name` - 文件名称。
- `$file.desc` - 文件描述。
- `$file.path` - 文件的绝对路径。
- `$file.parentDir` - 文件的父路径，以`/`开头,不以`/`结尾。项目的父路径会返回`/`。
- `$file.revision` - 文件的版本，每次修改，版本都会加1。
- `$file.projectName` - 文件的所属的项目。
- `$file.creator` - 创建人。
- `$file.createTime` - 创建时间。
- `$file.modifier` - 最后修改人。
- `$file.modifyTime` - 最后修改时间。
- `$file.type` - 文件类型。
- `$file.labels` - 文件的标签，是一个JSON数组。
- `$file.favorite` - 当前用户是否收藏了文件，是一个布尔值。
- `$file.customOption` - 扩展属性，是一个json，是用户自己定义的属性。