Hướng Dẫn Nhúng Tệp Tĩnh Vào Go Sử Dụng go:embed

Bạn cảm thấy việc sử dụng các tệp tĩnh riêng biệt trong các chương trình Go là rắc rối? Bạn đang tìm cách đơn giản hóa việc triển khai và phân phối các chương trình Go của mình? Nếu vậy, bạn may mắn rồi! Bài viết này sẽ hướng dẫn bạn cách sử dụng go:embed để nhúng các tệp tĩnh vào tệp nhị phân Go.

Contents

Chỉ Dẫn `//go:embed`

Chỉ dẫn //go:embed là tính năng mới được giới thiệu trong Go 1.16, giúp lập trình viên nhúng các tệp tĩnh trực tiếp vào tệp nhị phân Go, làm cho việc bao gồm các tệp như HTML, CSS, JavaScript và hình ảnh vào các ứng dụng Go trở nên dễ dàng hơn.

Ví dụ, để nhúng các tệp từ thư mục build, chúng ta có thể sử dụng mã sau:

package main

import (
    "embed"
)

//go:embed dist/*
var assets []byte

func main() {
    // Sử dụng tài nguyên khi cần...
}

Các Tùy Chọn Của `go:embed`

go:embed all:folder: Nhúng tất cả các tệp trong thư mục và các thư mục con.
go:embed pattern: Nhúng các tệp khớp với mẫu cụ thể.

Hãy cùng khám phá sự khác biệt giữa hai tùy chọn này:

go:embed all:folder

Cú pháp go:embed all:folder nhúng tất cả các tệp trong một thư mục và các thư mục con của nó. Tất cả các tệp, bao gồm cả những tệp bắt đầu với dấu chấm “.” hoặc dấu gạch dưới “_”, sẽ được nhúng vào trong biến chỉ định. Ví dụ:

//go:embed all:static
var staticAssets embed.FS

go:embed pattern

Cú pháp go:embed pattern nhúng một tập hợp các tệp cụ thể khớp với một mẫu nhất định. Chúng ta có thể sử dụng dấu sao (*) và các mẫu khác để chỉ định các tập hợp tệp phức tạp hơn để nhúng. Ví dụ:

//go:embed *.png
var imageFiles embed.FS

Tóm lại, chỉ thị go:embed cung cấp hai tùy chọn để chỉ định các tệp cần nhúng: go:embed all:folder và go:embed pattern. Tùy chọn đầu tiên được sử dụng để nhúng tất cả các tệp trong một thư mục và các thư mục con của nó, trong khi tùy chọn thứ hai được sử dụng để nhúng một tập hợp các tệp cụ thể khớp với một mẫu nhất định.

Hạn chế của `go:embed`

Mặc dù go:embed là một tính năng mạnh mẽ giúp đơn giản hóa việc triển khai các chương trình Go, nhưng nó cũng có một số hạn chế mà bạn cần lưu ý. Các hạn chế bao gồm:

Chỉ thị go:embed không hỗ trợ đường dẫn tệp động. Các đường dẫn tệp phải được biết tại thời điểm biên dịch.
Chỉ thị go:embed chỉ hoạt động với các tệp có thể truy cập từ thư mục làm việc hiện tại hoặc một thư mục con của nó. Điều này có nghĩa là bạn không thể sử dụng go:embed để nhúng các tệp ngoài thư mục dự án của bạn hoặc trong thư mục cha, như .git/* hoặc các liên kết biểu tượng.
Chỉ thị `go:embed không được phép khớp với các tệp có tên chứa các ký tự dấu câu đặc biệt như ” * < > ? ‘ | / \ :”

Reference

Embed package RFC
Go command support for embedded static assets Draft Design
Proposal cmd/go: support embedding static assets (files) in binaries
https://www.iamyadav.com/blogs/a-guide-to-embedding-static-files-in-go

Kết luận

Bằng cách tận dụng go:embed, các lập trình viên có thể đơn giản hóa việc triển khai và phân phối các chương trình Go bằng cách nhúng các tệp tĩnh trực tiếp vào mã nguồn. Mặc dù go:embed có một số hạn chế, nhưng đây vẫn là một tính năng mạnh mẽ có thể giúp tối giản hóa các chương trình Go và cải thiện quá trình triển khai.