# `changelog.txt` 格式

## `changelog.txt` 文件

WooCommerce 扩展使用标准的日志格式。`changelog.txt` 文件是 WooCommerce 市场上的扩展的必需文件。

您的 `changelog.txt` 文件应如下所示：

```php
*** WooCommerce 扩展名称 日志 ***

YYYY-MM-DD - 版本 1.1.0
* Added - 有用的新功能
    * 另一个新功能
    * 第三个新功能
* Fixed - 重要的 bug 修复
* Update - 与最新版本的兼容性

YYYY-MM-DD - 版本 1.0.1
* 修复了一个 bug

YYYY-MM-DD - 版本 1.0.0
* 初始发布
```

## 日志条目类型

为了展示产品更新中完成的不同类型的工作，请使用以下任何词语来表示每一行的更改类型：

- add
- added
- feature
- new
- developer
- dev
- tweak
- changed
- update
- delete
- remove
- fixed
- fix

## 日志嵌套

在特定条目类型下缩进的项目可以嵌套更多相同类型的更改，形成单级列表。

## 示例 `changelog.txt`

这是解析后的日志在 WooCommerce.com 上的模态框中的显示方式，其中每种条目类型都替换为图标。没有类型的日志条目会显示“其他”图标，而嵌套的条目则没有图标。

![在 WooCommerce.com 上显示的示例日志](https://woocommerce.com/wp-content/uploads/2025/11/changelog-formatting.png)