Clang-format未实现大括号换行，反而改为同行问题求助

Hey there! Let’s figure out why your clang-format is flipping your brace style on its head—sounds super frustrating when it does the exact opposite of what you want. Let’s break this down step by step.

The Root Cause: Misconfigured BreakBeforeBraces #

The main control for whether braces get their own line (or stick to the same line as the declaration) is the BreakBeforeBraces option in your .clang-format file. It’s almost certainly set to a value that enforces "attached" braces right now, instead of the "newline before" style you want.

What You Need for Your Desired Behavior

To get functions, enums, structs, and other top-level constructs to have braces on their own line, set BreakBeforeBraces to Allman (sometimes called BSD style). This style puts every opening brace on a new line, no exceptions.

Common Mistake: Accidental Attach/Other Styles

If your config has BreakBeforeBraces set to Attach, Google, Linux, or Mozilla, that’s why your braces are sticking to the same line. Those styles default to attached braces for most constructs.

Check for Conflicting Options #

Even if you set BreakBeforeBraces correctly, other settings can override it for specific cases. The most common culprit is AllowShortFunctionsOnASingleLine:

• If this is set to All or InlineOnlyExplicitlyDeclared, clang-format will cram short functions onto a single line (braces included) even if you want newlines.
• Fix this by setting it to None to force all functions to use your desired brace style.

Example Correct Configuration #

Here’s a minimal .clang-format snippet that should give you the behavior you want:

# .clang-format
BasedOnStyle: LLVM  # Or any base style you prefer—we’ll override the brace rule
BreakBeforeBraces: Allman
AllowShortFunctionsOnASingleLine: None
# Add any other custom rules you need below

Test the Fix #

To verify:

1. Save the config above (or adjust your existing one with these values)
2. Run clang-format -i your_source_file.cpp on a test file
3. Check if your code now looks like your expected behavior:

Expected (Correct) Output:

void myFunction()
{
    int x = 0;
}

enum StatusCodes
{
    OK,
    ERROR,
    PENDING
};

struct UserData
{
    std::string name;
    int age;
};

What You Were Seeing (Incorrect):

void myFunction() {
    int x = 0;
}

enum StatusCodes {
    OK,
    ERROR,
    PENDING
};

struct UserData {
    std::string name;
    int age;
};

Quick Troubleshooting Tip #

If you’re using a base style (like Google or Linux), remember that base styles set default values for many options. Always explicitly set BreakBeforeBraces after BasedOnStyle to override the base style’s settings—order matters here!

内容的提问来源于stack exchange，提问作者homeGrown