docs.rs по умолчанию собирает документацию под ARM64, а не под Intel

Сервис документации crates.io сменил список платформ по умолчанию. Вместо x86_64-apple-darwin теперь используется aarch64-apple-darwin, а вместо i686-unknown-linux-gnu — aarch64-unknown-linux-gnu.

Почему именно так

Первое изменение — следствие перехода Apple на собственные чипы ARM64 и соответствующей переоценки уровней поддержки: aarch64-apple-darwin стал первого уровня, x86_64-apple-darwin опустился до второго.

Второе связано с 32-битным Linux: поддержка i686 падает, и крупные дистрибутивы уже начали от неё отказываться. Собирать документацию под платформу, которой скоро не будет, смысла нет.

Новый список по умолчанию

x86_64-unknown-linux-gnu, aarch64-apple-darwin, x86_64-pc-windows-msvc, aarch64-unknown-linux-gnu, i686-pc-windows-msvc.

Поддержка самих платформ при этом не ограничена: docs.rs продолжает собирать документацию для любой цели, доступной в тулчейне. Изменился только список по умолчанию.

Что это значит для авторов крейтов

Документация на crates.io теперь по умолчанию собирается под Linux на ARM64 и под Apple silicon. Код, использующий платформенные возможности или различающий платформы через #[cfg(target_arch)], может вести себя иначе на страницах документации, чем на машине читателя.

Если это важно — например, нужно проверить поведение именно на 32-битной платформе — список следует зафиксировать явно в [package.metadata.docs.rs] полем targets. Это одна строка в манифесте.

Оригинал

docs.rs: changed default targets от 16 октября 2025 года; RFC 3671 и RFC 3841