В экосистеме языка Go интеграция с нативными библиотеками на C через механизм cgo исторически сопряжена с серьезным эксплуатационным трением. Для сборки любого проекта, использующего cgo, в сборочной среде обязательно требуется полноценный компилятор C (GCC или Clang). Это раздувает базовые Docker-образы, усложняет CI/CD и превращает кросс-компиляцию под другие платформы в мучительную настройку сторонних тулчейнов.
В официальном репозитории golang/go зарегистрировано архитектурное предложение (issue #81450, «cmd/cgo: cgo without a C toolchain»), призванное устранить эту многолетнюю проблему.
Авторы предлагают внедрить директиву //cgo:binding. С ее помощью автор библиотеки описывает сигнатуру внешней C-функции непосредственно в Go-файле. На этапе разработки пакета утилита cmd/cgo один раз генерирует связующие мосты на чистом Go и платформенном ассемблере, реализующие соглашение о вызовах C ABI (System V AMD64 или ARM64 AAPCS):
package fastcrypto
// Декларация нативной функции без включения заголовочных файлов C
//cgo:binding sha256_hardware_block(data *byte, len int)
//cgo:link -lfastcrypto
func sha256HardwareBlock(data *byte, len int)
Сгенерированный ассемблерный переходник берет на себя переключение стека горутины на системный стек и передачу аргументов в регистры процессора:
// Ассемблерный мост cmd/cgo для вызова C ABI без компилятора C
TEXT ·sha256HardwareBlock(SB), NOSPLIT, $0-16
MOVQ data+0(FP), DI // Первый аргумент в регистр RDI
MOVQ len+8(FP), SI // Второй аргумент в регистр RSI
CALL ·cgocall_c_abi(SB) // Вызов диспетчера системного ABI
RET
Конечный пользователь библиотеки сможет скомпилировать проект командой go build с флагом CGO_ENABLED=0, не устанавливая в операционную систему ни строчки стороннего C-тулчейна.
