syntax error at ... line ..., near '...'

The “syntax error at … line …, near ‘…’” error in Perl means the compiler encountered a construct it could not parse — Perl stopped before executing anything.

What It Means

Perl compiles your script before running it. During compilation, the parser breaks your code into tokens and checks them against Perl’s grammar. When it finds a sequence of tokens it cannot make sense of, it reports a syntax error with the line number and the offending tokens. Because Perl parses from top to bottom, the line number points to where the parser got confused, but the actual mistake may be earlier in the file.

Why It Happens

• A missing semicolon at the end of a statement.
• An unmatched opening or closing brace, parenthesis, or bracket.
• An unterminated string literal (missing closing quote).
• A missing comma in a list: my @items = ("one" "two").
• Incorrect block structure — if without a condition, else without preceding if.
• A qw() list with an extra delimiter or unbalanced parentheses.
• A heredoc with the wrong terminator.

How to Fix It

1. Check for missing semicolons

use strict;
use warnings;

# Bad — missing semicolon
my $name = "Alice"
print $name;

# Good
my $name = "Alice";
print $name;

2. Match all braces, parentheses, and brackets

# Bad — missing closing brace
if ($x > 0) {
    print "Positive";

# Good
if ($x > 0) {
    print "Positive";
}

3. Look for unterminated strings

# Bad — missing closing quote
my $text = "Hello, world;
print $text;

# Good
my $text = "Hello, world";
print $text;

4. Add commas in list literals

# Bad — missing comma
my @colors = ("red" "green" "blue");

# Good
my @colors = ("red", "green", "blue");

# qw() does not use commas — it splits on whitespace
my @colors = qw(red green blue);

5. Check your block structure

# Bad — no condition after if
if {
    print "always";
}

# Good
my $flag = 1;
if ($flag) {
    print "true";
}

6. Use Perl syntax checking without running

perl -c script.pl

# This compiles the script without executing it
# Output: script.pl syntax OK

7. Enable warnings and strict to surface issues early

use strict;
use warnings;

# These pragmas turn many subtle issues into clear errors