README.md

go-perfbook

This document outlines best practices for writing high-performance Go code.

The first sections cover writing optimized code in any language. The later sections cover Go-specific techniques.

Multiple Language Versions

• English
• 中文
• Español
• Português Brasileiro

Table of Contents

1. Writing and Optimizing Go code
2. How to Optimize
   1. Optimization Workflow
   2. Concrete Optimization Tips
3. Data Changes
4. Algorithmic Changes
5. Benchmark Inputs
6. Program Tuning
7. Optimization Workflow Summary
8. Garbage Collection
9. Runtime and Compiler
10. Unsafe
11. Common gotchas with the standard library
12. Alternate Implementations
13. CGO
14. Advanced Techniques
15. Assembly
16. Optimizing an Entire Service
17. Tooling
    1. Profiling
    2. Tracer
18. Appendix
    1. Implementing Research Papers

Contributing

This is a work-in-progress book in Go performance.

There are different ways to contribute:

1. add to or summarizes the resources in TODO
2. add bullet points or new topics to be covered
3. write prose and flesh out the sections in the book

Eventually sample programs to optimize and exercises will be needed (maybe).

Coordination will be done in the #performance channel on the Gophers slack.