Визуализатор раскрытия макросов Rust
Посмотрите, во что раскрываются макросы Rust. Наш визуализатор раскрытия макросов Rust находит и показывает более 20 типов макросов, включая println!, vec!, format!, определения macro_rules!, атрибутные макросы #[derive()] и собственные процедурные макросы. Для каждого найденного макроса приводится раскрытая форма, подробное пояснение и номер строки исходного кода. Бесплатно, конфиденциально и без регистрации.
Detect and visualize Rust macro expansions. Automatically identifies built-in macros (println!, vec!, format!, assert!), macro_rules! definitions, #[derive(...)] attribute macros, and custom proc macros. Shows expanded forms, explanations, and recursion detection. All processing is local - no server upload required.
Paste Rust code above and click Analyze Macros to detect and visualize macro expansions. The tool identifies built-in macros (println!, vec!, format!), macro_rules! definitions, #[derive] attributes, and custom procedural macros. Try loading an example to see how it works!
Зачем использовать наш визуализатор раскрытия макросов Rust?
- Широкое распознавание макросов: автоматически находит более 20 типов макросов Rust: встроенные (println!, vec!, format!, concat!, stringify!), объявления (macro_rules!), атрибутные (#[derive(...)]) и собственные процедурные макросы. Для каждого макроса указываются имя, аргументы и номер строки исходного кода — полная прозрачность использования макросов в вашем коде.
- Симуляция раскрытия и поиск рекурсии: показывает, во что раскрывается каждый макрос, с помощью симулированных раскрытых форм. Встроенные макросы показывают эквивалентный код, определения macro_rules! — свои ветки сопоставления, а рекурсивные макросы помечаются индикаторами глубины. Разберитесь, как именно работает насыщенный шаблонами код Rust во время компиляции.
- Обучающие пояснения и контекст: для каждого найденного макроса приводится подробное пояснение его назначения, работы и результата во время компиляции. Идеально для изучения макрос-системы Rust: разберитесь на реальных примерах, чем отличаются декларативные macro_rules!, процедурные макросы и встроенные макросы компилятора.
- 100 % локально в браузере и конфиденциально: весь анализ макросов Rust выполняется полностью в вашем браузере. Ваш код, все найденные макросы, визуализации раскрытия и результаты анализа никогда не покидают устройство. Никаких загрузок на сервер, вызовов API, хранения данных и отслеживания. Идеально для анализа проприетарного кода или конкурентного анализа.
Что такое раскрытие макросов Rust?
Раскрытие макросов Rust — это процесс во время компиляции, в ходе которого вызовы макросов преобразуются в настоящий код Rust. Когда компилятор Rust встречает вызов макроса вроде println!("Привет, ", name), он заменяет его сгенерированным кодом до того, как продолжается проверка типов и компиляция. В Rust есть три вида макросов: декларативные (macro_rules!), использующие сопоставление с образцом; процедурные, выполняющие произвольный код Rust во время компиляции (например, #[derive(Serialize)]); и встроенные макросы компилятора (println!, vec!, format!), которые входят в сам компилятор. Понимание раскрытия макросов необходимо для отладки, ревью кода и изучения продвинутых приёмов Rust.
Как работает наш визуализатор раскрытия макросов Rust
Визуализатор анализирует исходный код Rust с помощью сопоставления шаблонов с учётом языка, чтобы определить различные типы макросов. Встроенные макросы вроде println!, vec!, format! и concat! определяются по известным именам и структуре аргументов — для каждого есть свой симулятор раскрытия, показывающий эквивалентный сгенерированный код. Определения macro_rules! находятся, а их ветки сопоставления разбираются, чтобы показать пары «образец — преобразователь». Атрибуты #[derive(...)] разбираются, чтобы перечислить создаваемые реализации трейтов. Собственные макросы определяются как любой идентификатор, за которым следует ! и который не является известным встроенным макросом. Рекурсивные макросы находятся поиском самоссылающихся вызовов внутри определения. Вся обработка выполняется локально в браузере, без обращения к серверу.
Макросы Rust и другие языки
Макрос-система Rust принципиально отличается от препроцессора C/C++. В отличие от #define в C, который просто заменяет текст, макросы Rust работают на уровне токенов и соблюдают синтаксические границы. Это значит, что макросы Rust гигиеничны (они не захватывают случайно переменные из вызывающей области), поддерживают сопоставление с образцом по синтаксическим структурам и интегрируются с системой типов Rust. Процедурные макросы в Rust ещё мощнее: они получают поток токенов во время компиляции и создают новый поток токенов, что позволяет генерировать сложный код для сериализации (serde), веб-фреймворков (actix-web, rocket) и ORM для баз данных (diesel, sqlx). Поэтому макросы Rust безопасны, композируемы и куда мощнее традиционных макросов препроцессора и даже шаблонов C++.
Конфиденциальность, безопасность и ограничения
Этот инструмент работает полностью в вашем браузере на клиентском JavaScript. Код Rust, который вы вставляете, все найденные макросы, визуализации раскрытия и результаты анализа никогда не отправляются на сервер. Однако есть важные ограничения, о которых стоит знать. Инструмент даёт симулированное раскрытие для встроенных макросов и структурный анализ для определений macro_rules!, но не выполняет процедурные макросы и не раскрывает полностью рекурсивные макросы с состоянием времени выполнения. Раскрытая форма — это учебное приближение, а не точный вывод компилятора. Для точного раскрытия макросов используйте cargo expand или rustc -Z macro-backtrace. Инструмент может не находить макросы из внешних крейтов, если их шаблоны вызова не входят в анализируемый код.
Часто задаваемые вопросы
Инструмент находит более 20 типов макросов Rust, включая встроенные макросы (println!, vec!, format!, concat!, stringify!, assert!, matches!, panic!, todo!), определения macro_rules! с их ветками сопоставления, атрибутные макросы #[derive(...)] со списком трейтов, собственные макросы, похожие на функции, и собственные атрибутные макросы. Он также находит шаблоны рекурсивных макросов с отслеживанием глубины.
Инструмент анализирует исходный код Rust с помощью сопоставления шаблонов с учётом языка, чтобы определить разные типы макросов. Для каждого встроенного макроса есть свой симулятор раскрытия, показывающий эквивалентный сгенерированный код. Определения macro_rules! разбираются на ветки сопоставления. Атрибуты #[derive] показывают, какие реализации трейтов создаются. Собственные макросы определяются по имени и шаблону вызова. Вся обработка идёт локально в вашем браузере, без обращения к серверу.
Нет. Процедурные макросы нельзя раскрыть в браузере, так как для этого нужно выполнить настоящий код крейта процедурного макроса внутри компилятора Rust во время компиляции. Вместо этого инструмент показывает общее пояснение того, что, судя по имени и контексту, должен делать процедурный макрос. Для точного раскрытия используйте cargo expand или rustc -Z macro-backtrace.
Визуализация раскрытия даёт учебные приближения. Встроенные макросы вроде println! и vec! раскрываются точно, исходя из документированного поведения. Определения macro_rules! показывают структурный анализ. Для точного раскрытия используйте cargo expand, который запускает настоящий компилятор. Этот инструмент предназначен для обучения, ревью кода и быстрого анализа, а не для замены инструментов уровня компилятора.
Когда макрос macro_rules! вызывает сам себя внутри собственного раскрытия, он помечается как рекурсивный. Инструмент подсчитывает найденные уровни самоссылок и показывает глубину. Рекурсивные макросы часто используются в Rust для реализации конечных автоматов, рекурсивных структур данных и некоторых шаблонов DSL.
Разумеется. Визуализатор раскрытия макросов Rust работает полностью в вашем браузере. Ваш код Rust, все найденные макросы, визуализации раскрытия и результаты анализа никогда не покидают ваше устройство. Никаких загрузок на сервер, вызовов API, аналитического отслеживания, файлов cookie и сбора данных любого рода.
Да — 100 % бесплатно, без регистрации, без аккаунта и без ограничений по использованию. Анализируйте столько кода Rust, сколько нужно, и сколько угодно раз. Нет премиум-тарифов, скрытых платежей и лимитов на запросы. Инструмент работает полностью в вашем браузере.