syntax error: unexpected ...

The “syntax error: unexpected” error in Go means the parser encountered a token that does not belong in the current context. This is the compiler’s way of saying your code does not follow Go’s grammar rules.

What It Means

Go’s parser reads your source code token by token. When it finds a token that is not valid at the current position — such as a closing brace without an opening one, or an operator in the wrong place — it stops and reports the unexpected token along with its location.

Why It Happens

• A curly brace { or } is missing or misplaced.
• A parenthesis ( or ) is unmatched.
• A comma is missing in a multi-line struct, slice, or map literal.
• An operator like = is used instead of == for comparison, or vice versa.
• A semicolon is inserted incorrectly by the compiler’s automatic semicolon insertion.
• A return statement has a line break before its operand.

How to Fix It

1. Check for unmatched braces

A common mistake is forgetting to close a function or struct:

func main() {
    fmt.Println("Hello")
// Missing closing brace — causes "syntax error: unexpected EOF"

// Fix: add the missing brace
func main() {
    fmt.Println("Hello")
}

2. Add missing commas in composite literals

Go requires a trailing comma in multi-line literals:

// Missing comma — causes "syntax error: unexpected newline"
names := []string{
    "Alice"
    "Bob",
}

// Fix: add comma after each element
names := []string{
    "Alice",
    "Bob",
}

3. Check return statement placement

A return with a line break before the value is treated as a bare return:

// This causes "syntax error: unexpected {name}"
return
    result

// Fix: keep return and value on the same line
return result

// Or wrap in parentheses
return (
    result,
)

4. Use the correct comparison operator

Assignment = vs comparison == is a frequent source of errors:

// Causes "syntax error: unexpected ==" when used in an assignment context
// or "syntax error: unexpected =" in an if condition
if x = 10 {  // should be ==
}

// Fix: use == for comparison
if x == 10 {
}

5. Remove stray characters

Check for accidental characters such as a stray semicolon inside a struct definition:

type Person struct {
    Name string;
    // Semicolon in struct causes "syntax error: unexpected ;"
}

Remove the semicolon — Go does not use them in type definitions.

FAQ