Как можно получить полную иерархию директив #include в проекте?

Чтобы получить полную иерархию директив `#include` в C или C++ проекте, вы можете воспользоваться несколькими методами. Вот несколько подходов:

### 1. Использование препроцессора

Вы можете использовать компилятор для получения информации о включённых файлах. Например, для GCC или Clang, вы можете использовать флаги для вывода информации о препроцессорных директивах. Выполните команду:

```bash
gcc -E your_source_file.c -o - | less
```

или (для C++)

```bash
g++ -E your_source_file.cpp -o - | less
```

Этот режим (`-E`) заставит компилятор выполнить все препроцессорные операции. Вы сможете увидеть все директивы `#include` и их иерархию.

### 2. Использование специализированных инструментов

Существуют инструменты, которые могут помочь анализировать зависимости и иерархию файлов:

- **CMake**: Если ваш проект использует CMake, вы можете использовать команду `cmake --graphviz=output.dot .` для генерации файла в формате DOT, который затем можно визуализировать.
  
- **Include Graph Visualizer**: Некоторые IDE и программы, такие как Qt Creator или Visual Studio, имеют встроенные функции визуализации зависимостей, которые могут отобразить иерархию включаемых файлов.

- **Doxygen**: Этот инструмент может генерировать документацию из исходного кода, и вы можете настроить его для того, чтобы он также отображал графики зависимостей.

### 3. Письменный скрипт

Если вам необходимо, вы также можете написать скрипт на Bash, Python или другом языке, который будет выполнять парсинг ваших файлов и собирать информацию о `#include`. Например, можно использовать регулярные выражения для поиска директив `#include`.

Пример на Python:

```python
import os
import re

def find_includes(file_path):
    includes = []
    with open(file_path, 'r') as f:
        for line in f:
            match = re.match(r'^\s*#\s*include\s*[<"]([^">]+)[">]', line)
            if match:
                includes.append(match.group(1))
    return includes

def collect_includes(start_path):
    all_includes = {}
    for root, _, files in os.walk(start_path):
        for file in files:
            if file.endswith(('.c', '.cpp', '.h', '.hpp')):
                full_path = os.path.join(root, file)
                all_includes[full_path] = find_includes(full_path)
    return all_includes

if __name__ == "__main__":
    project_directory = 'path/to/your/project'
    includes_hierarchy = collect_includes(project_directory)
    for file, includes in includes_hierarchy.items():
        print(f'{file}: {includes}')
```

### Заключение

Выбор метода зависит от ваших нужд и размеров проекта. Если вам просто нужно быстро просмотреть, инструментарий компилятора будет наиболее простым решением. Если требуется более глубокий анализ, лучше использовать специализированные инструменты или написать собственный парсер.