---
name: Group Files by Name
slug: group-by-name
category: Automation
description: Group files into different directories based on file name rules, such as prefixes or patterns. Use this when you need to automatically organize files by name, for example, sorting documents into folders according to their naming conventions.
github: "https://github.com/CoderWanFeng/python-office/tree/develop/skills/file/group_by_name"
language: Python
stars: 1331
forks: 297
install: "git clone https://github.com/CoderWanFeng/python-office"
added: 2026-07-20T06:48:43.625Z
last_synced: 2026-07-28T07:00:50.400Z
canonical_url: "https://dirskills.com/skills/group-by-name"
---

# Group Files by Name

Group files into different directories based on file name rules, such as prefixes or patterns. Use this when you need to automatically organize files by name, for example, sorting documents into folders according to their naming conventions.

**Install:** `git clone https://github.com/CoderWanFeng/python-office`

## README

# group_by_name Skill

> 按名称分组整理文件

## 功能描述

按文件名的前缀或规则，将文件分组整理到不同目录中。

> ⚠️ TODO: 该功能为历史功能，行为待测试。

## 所属分类

`office/skills/file/group_by_name/`

## 调用方式

```python
from office.skills.file import group_by_name

group_by_name(
    path='./data',
    output_path=None,
    del_old_file=None
)
```

## 参数说明

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `path` | str | 是 | - | 路径 |
| `output_path` | str | 否 | `None` | 输出路径 |
| `del_old_file` | bool | 否 | `None` | 是否删除旧文件 |

## 返回值

`None`

## 原始函数

`office.api.file.group_by_name`