包裝宣告

  • 原始碼和註釋一般不應超過每行 80 個字元,每行最多不超過 100 個字元,包括縮排。

    必須根據具體情況判斷字元限制。真正重要的是線條的語義密度和可讀性。無線長線使他們難以閱讀; 類似地,進行英雄嘗試以使它們適合 80 列也可能使它們難以閱讀。此處概述的靈活性旨在使開發人員能夠避免這些極端情況,而不是最大限度地利用監控房地產。

  • 不應包裝 URL 或示例命令。

// Ok even though it might exceed max line width when indented.
Error e = isTypeParam
        ? Errors.InvalidRepeatableAnnotationNotApplicable(targetContainerType, on)
        : Errors.InvalidRepeatableAnnotationNotApplicableInContext(targetContainerType));

// Wrapping preferable
String pretty = Stream.of(args)
                      .map(Argument::prettyPrint)
                      .collectors(joining(", "));

// Too strict interpretation of max line width. Readability suffers.
Error e = isTypeParam
        ? Errors.InvalidRepeatableAnnotationNotApplicable(
                targetContainerType, on)
        : Errors.InvalidRepeatableAnnotationNotApplicableInContext(
                targetContainerType);

// Should be wrapped even though it fits within the character limit
String pretty = Stream.of(args).map(Argument::prettyPrint).collectors(joining(", "));
  • 在較低的句法水平上包裝比在較高的句法水平上包裝更受歡迎。

  • 每行最多應有 1 個語句。

  • 延續線應採用以下四種方式之一縮排

    • 變體 1 :相對於前一行的縮排有 8 個額外空格。
    • 變體 2 :相對於包裝表示式的起始列有 8 個額外空格。
    • 變體 3 :與先前的兄弟表示式一致(只要它是一個延續線)
    • 變體 4 :與連結表示式中的先前方法呼叫對齊。