81

Eclipse の組み込み Java コード フォーマッタにコメントを無視させる方法はありますか? 実行すると、次のようになります。

    /*
     * PSEUDOCODE
     * Read in user's string/paragraph
     * 
     * Three cases are possible
     * Case 1: foobar
     *         do case 1 things
     * Case 2: fred hacker
     *         do case 2 things
     * Case 3: cowboyneal
     *         do case 3 things
     *         
     * In all cases, do some other thing
     */

これに：

    /*
     * PSEUDOCODE Read in user's string/paragraph
     * 
     * Three cases are possible Case 1: foobar do case 1 things Case 2: fred
     * hacker do case 2 things Case 3: cowboyneal do case 3 things
     * 
     * In all cases, do some other thing
     */

Windows > Preferences > Java > Code Style > Formatter の設定をいじってみましたが、コメントの書式設定を維持するための設定が見つかりません。私はEclipse 3.4.0を使用しています。

4

11 に答える 11

187

特定のブロック コメントの書式設定を抑制するために使用できる別のソリューションがあります。ブロック コメントの先頭で (ハイフンに注意してください)を使用する/*-と、ファイルの残りの部分をフォーマットしても、フォーマットは影響を受けません。

/*-
 * これは非常に特別なブロック コメントです。
 * indent(1) で無視したいフォーマット。
 *
 * 1
 * 2
 * 三
 */

ソース: http://www.oracle.com/technetwork/java/javase/documentation/codeconventions-141999.html#350

于 2011-03-28T23:19:36.897 に答える
41

OPとこの回答で指摘されているように、2010年の更新で// @formatter:offは、Eclipse3.6の特別な文字列で十分です。

質問の時点では利用できませんでした。

元の回答：2009年6月、Eclipse 3.4 / 3.5

Java Formatter（Windows > Preferences > Java > Code Style > Formatter）を使用すると、新しいFormatterプロファイルを作成できます。

[コメント]タブ（eclipse3.5の場合）で、["]の["]のJavadoc comment settingsチェックを外すことを確認できますFormat HTML tags。「」セクションの「」
も確認してください。Never join linesGeneral settings

次に、コメントは次のように書く必要があります。

/**
 * PSEUDOCODE
 * Read in user's string/paragraph
 * 
 * Three cases are possible:
 * <dl>
 *   <dt>Case 1: foobar</dt>
 *     <dd>        do case 1 things</dd>
 *   <dt>Case 2: fred hacker</dt>
 *     <dd>        do case 2 things</dd>
 *   <dt>Case 3: cowboyneal</dt>
 *     <dd>        do case 3 things</dd>
 * </dl>        
 * In all cases, do some other thing
 */

注：私はJavadocコメントを作成しましたが、単純なコメントではありません。これほど多くのテキストを含むコメントは、メソッドの前に配置した方がよいと思います。さらに、Javadocセクションには、より多くのフォーマットパラメータがあります。
メソッド（真のJavadoc）の前にある場合、HTMLタグ<dl>は、<dt><dd> Javadocビュー内で適切に表示するのに役立ちます。

于 2009-06-22T05:45:43.697 に答える
26

同僚から、Eclipse がこれに使用できる特別なフォーマット タグを提供していることを知りました。

// @formatter:off
/*
 * ╔════════╦═══════╦══════════╗
 * ║ Month  ║ Sales ║ Position ║
 * ╠════════╬═══════╬══════════╣
 * ║ June   ║ 44k   ║ 2nd      ║
 * ║ July   ║ 39k   ║ 2nd      ║
 * ║ August ║ 49k   ║ 4th      ║
 * ╚════════╩═══════╩══════════╝
 *
 * This comment shouldn't be formatted, and will now be ignored by the formatter.
 */
// @formatter:on

[設定] メニュー → [Java] > [コード スタイル] > [フォーマッタ] で、[編集] をクリックし、[オフ/オン タグ] タブを選択し、 [オフ/オン タグを有効にする] ( source )をオンにして、この機能を手動で有効にする必要がある場合があることに注意してください。

文字列@formatter:offの簡単な Google は、コード ブロックのフォーマッターを無効にするというコンテキストでこの機能について言及した、この他の SO answerに私をもたらしました。行コメント、「通常の」ブロックコメント、Javadoc ブロックコメントでも動作することを確認しました。

于 2012-08-28T16:33:01.803 に答える
20

もう 1 つの可能性は、Javadoc で HTML の <pre> を使用することです。

/**
 * <pre>
 *    this
 *   is
 *      kept
 *  as
 *    is
 * </pre>
 */

少なくとも、これは私が自分のASCIIアートをソースコードのコメントに埋め込む方法です:)

于 2013-01-03T14:00:48.773 に答える
9

特定のテキストを<pre> </pre>タグで囲みます。

于 2010-02-10T17:57:03.967 に答える
2

Eclipse 3.4 の場合: [設定]、[Java]、[コード スタイル]、[フォーマッタ]、[プロファイルの編集]、[コメント] タブの順に選択します。コメントのフォーマットを制御するためのオプションがたくさんあります。

于 2009-06-21T22:31:51.363 に答える