Use the template.ParseFS and embed package to compile HTML templates into binary files. 1. Import the embed package and embed the template file into the embed.FS variable with //go:embed templates/.html; 2. Call template.Must(template.ParseFS(templateFS, "templates/.html"))) to parse all matching template files; 3. Render the specified template in the HTTP processor through tmpl.ExecuteTemplate(w, "home.html", nil). This method does not require the runtime to rely on external files, generates a self-contained executable file, and the path and extension must be exactly matched to ensure the correct case and wildcard patterns.
Starting with Go 1.16, you can use the embed
package along with template.ParseFS
to load HTML templates (or any text-based templates) directly from the filesystem at compile time. This is especially useful for web applications where you want to bundle templates into the binary.

Here's how to use template.ParseFS
with //go:embed
.
? Step 1: Embed Files Using embed
First, import the embed
package and use the //go:embed
directive to include your template files.

package main import ( "embed" "html/template" "net/http" )
Suppose you have a directory called templates/
with files like:
templates/ home.html layout.html footer.html
You can embed the entire directory:

//go:embed templates/*.html var templateFS embedded.FS
Note: You can also use
templates/
to include subdirectories, or be more specific with patterns.
? Step 2: Parse Templates Using template.ParseFS
Now use template.ParseFS
to parse the embedded files:
tmpl := template.Must(template.ParseFS(templateFS, "templates/*.html"))
This reads all .html
files in the templates/
directory and parses them into a *template.Template
.
If you have nested directories:
//go:embed templates/* var templateFS embedded.FS tmpl := template.Must(template.ParseFS(templateFS, "templates/**/*.html"))
The **
allows recursive matching.
? Step 3: Use the Template in an HTTP Handler
func handler(w http.ResponseWriter, r *http.Request) { err := tmpl.ExecuteTemplate(w, "home.html", nil) if err != nil { http.Error(w, err.Error(), http.StatusInternalServerError) } }
Then register it:
func main() { http.HandleFunc("/", handler) http.ListenAndServe(":8080", nil) }
? Example Directory Structure
project/ ├── main.go ├── templates/ │ ├── home.html │ ├── layout.html │ └── footer.html
main.go
:
package main import ( "embed" "html/template" "net/http" ) //go:embed templates/*.html var templateFS embedded.FS func main() { tmpl := template.Must(template.ParseFS(templateFS, "templates/*.html")) http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) { err := tmpl.ExecuteTemplate(w, "home.html", nil) if err != nil { http.Error(w, err.Error(), http.StatusInternalServerError) } }) http.ListenAndServe(":8080", nil) }
?? Common Pitfalls
- File extension matters : Make sure the template filenames match what you pass to
ExecuteTemplate
. - Glob pattern must match : If your files aren't being picked up, double-check the glob pattern in
ParseFS
. - Case sensitivity : Embedded paths are case-sensitive.
- Don't forget the
embed
import — even if you don't use it directly, it's required for//go:embed
to work.
? Summary
To use template.ParseFS
with embed
:
- Use
//go:embed
to embed template files into anembed.FS
variable. - Call
template.ParseFS(fs, "pattern")
to parse matching files. - Execute the desired template by name.
This approach avoids relying on external files at runtime and creates a fully self-contained binary.
Basically, that's it — clean, efficient, and idiomatic Go.
The above is the detailed content of How to use template.ParseFS with go embed?. For more information, please follow other related articles on the PHP Chinese website!

Hot AI Tools

Undress AI Tool
Undress images for free

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Notepad++7.3.1
Easy-to-use and free code editor

SublimeText3 Chinese version
Chinese version, very easy to use

Zend Studio 13.0.1
Powerful PHP integrated development environment

Dreamweaver CS6
Visual web development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

Hot Topics

Go's switch statement will not be executed throughout the process by default and will automatically exit after matching the first condition. 1. Switch starts with a keyword and can carry one or no value; 2. Case matches from top to bottom in order, only the first match is run; 3. Multiple conditions can be listed by commas to match the same case; 4. There is no need to manually add break, but can be forced through; 5.default is used for unmatched cases, usually placed at the end.

In Go, to break out of nested loops, you should use labeled break statements or return through functions; 1. Use labeled break: Place the tag before the outer loop, such as OuterLoop:for{...}, use breakOuterLoop in the inner loop to directly exit the outer loop; 2. Put the nested loop into the function, and return in advance when the conditions are met, thereby terminating all loops; 3. Avoid using flag variables or goto, the former is lengthy and easy to make mistakes, and the latter is not recommended; the correct way is that the tag must be before the loop rather than after it, which is the idiomatic way to break out of multi-layer loops in Go.

Usecontexttopropagatecancellationanddeadlinesacrossgoroutines,enablingcooperativecancellationinHTTPservers,backgroundtasks,andchainedcalls.2.Withcontext.WithCancel(),createacancellablecontextandcallcancel()tosignaltermination,alwaysdeferringcancel()t

Use a dedicated and reasonably configured HTTP client to set timeout and connection pools to improve performance and resource utilization; 2. Implement a retry mechanism with exponential backoff and jitter, only retry for 5xx, network errors and 429 status codes, and comply with Retry-After headers; 3. Use caches for static data such as user information (such as sync.Map or Redis), set reasonable TTL to avoid repeated requests; 4. Use semaphore or rate.Limiter to limit concurrency and request rates to prevent current limit or blocking; 5. Encapsulate the API as an interface to facilitate testing, mocking, and adding logs, tracking and other middleware; 6. Monitor request duration, error rate, status code and retry times through structured logs and indicators, combined with Op

To correctly copy slices in Go, you must create a new underlying array instead of directly assigning values; 1. Use make and copy functions: dst:=make([]T,len(src));copy(dst,src); 2. Use append and nil slices: dst:=append([]T(nil),src...); both methods can realize element-level copying, avoid sharing the underlying array, and ensure that modifications do not affect each other. Direct assignment of dst=src will cause both to refer to the same array and are not real copying.

Go uses time.Time structure to process dates and times, 1. Format and parse the reference time "2006-01-0215:04:05" corresponding to "MonJan215:04:05MST2006", 2. Use time.Date(year, month, day, hour, min, sec, nsec, loc) to create the date and specify the time zone such as time.UTC, 3. Time zone processing uses time.LoadLocation to load the position and use time.ParseInLocation to parse the time with time zone, 4. Time operation uses Add, AddDate and Sub methods to add and subtract and calculate the interval.

Use the template.ParseFS and embed package to compile HTML templates into binary files. 1. Import the embed package and embed the template file into the embed.FS variable with //go:embedtemplates/.html; 2. Call template.Must(template.ParseFS(templateFS,"templates/.html")))) to parse all matching template files; 3. Render the specified in the HTTP processor through tmpl.ExecuteTemplate(w,"home.html", nil)

To import local packages correctly, you need to use the Go module and follow the principle of matching directory structure with import paths. 1. Use gomodinit to initialize the module, such as gomodinitexample.com/myproject; 2. Place the local package in a subdirectory, such as mypkg/utils.go, and the package is declared as packagemypkg; 3. Import it in main.go through the full module path, such as import "example.com/myproject/mypkg"; 4. Avoid relative import, path mismatch or naming conflicts; 5. Use replace directive for packages outside the module. Just make sure the module is initialized
