2024-06-12 追記: 書いた内容自体はそうなんだけど、なんだかんだで `final` 書くほうがいいやってなってます😜 ほら、「やめてみた」なんで。ほら。

Javaの話ね。バージョンは8以降の実質的final（effectively final）があるものとします。7以前は匿名クラス（この呼び方は匿名クラスとかローカルクラスとか参照）でローカル変数を使うにはfinalが必要なので文脈変わります。

前提の整理

final は色々なところにつけられます。例えばこんな感じ。

final class FooClass {

    final Object barField = new Object();

    final void bazMethod(final Object quxParameter) {
        final Object corgeLocalVariable;
    }
}

このエントリで対象にするのは変数。フィールド barField 、パラメータ quxParameter、ローカル変数 corgeLocalVariable です。

以下を前提にします。

自分たちだけが使用するコードです。不特定多数から使用されるライブラリなどではありません。
クラスやメソッドの final は対象外です。意味も違うし。
アクセス修飾子も今回は存在自体を忘れてください。
XXX（某JVM言語や某ライブラリ）使えば？ は堪えてください。言いたくなる気持ちはわかるつもりですが、そっちに脱線すると帰ってこれなくなりますので。
Java 11の var も別の話。

`final` をつける意義と実際

再代入不可になり、コンパイルレベルでチェックしてくれます。これにより再代入が原因となる不具合が防げます。

再代入を許容すると状態が変わるため「この時点ではどうなるんだっけ？」と悩むことになります。無用な状態遷移に悩まされないように final をつけることを推奨するコーディング規約や、静的解析ツールも存在します。

で、実際のとこどうなのよと言うと、こんな感じになります。

フィールド: 可能なら final にする。
パラメータ: まちまち。周囲が付けてたら合わせて付ける。
ローカル変数: わざわざ付けない。そう言う規約なら従う。けど付いてるのをわざわざ外したりもしない。

新しくプロジェクトに参画して、借りてきた猫モードしてる時はだいたいこうします。

フィールドを final にするのはイミュータブルが好ましいと言う最近の傾向や、完全コンストラクタに対応するバインディングライブラリなどの後押しもあります。こんなクラスですね。

// 完全コンストラクタの例（イミュータブルの例ではない）
class Hoge {

    final Object field;

    Hoge(Object field) {
        this.field = field;
    }
}

フィールドはわかりやすいのですが、パラメータやローカル変数は様々です。「パラメータは絶対上書きなんてしてはいけない。だから final を付ける。」と言うのは、前半は完全に同意。後半もまあいいかな、と言う感じです。付ける派のほうが強い意思を持つものなので、わざわざ喧嘩する必要もないかなって。

ローカル変数は、まあ、スコープが広い（数千行に及ぶ）とかなら、付けるのもわかるかも……。

ともかくコンテキストを絞らずに驚き最小の法則を適用するなら、先に挙げたような感じになると思います。

この辺りの話はふつうのJavaコーディングの初段と四段あたりが該当します。で、次が九段の「強い意思でルールを破る」です。

`final` を付けるのをやめた

最近は final を付けません。

だからと言っても、再代入を推奨するわけではありません。 finalなんて付けなくても、 どうせ再代入なんてしない のです。あってもなくても一緒ならあるだけノイズです。

もし final によりうっかり再代入してしまうことを防いでるのだとしたら、うっかり再代入をする方が問題です。うっかり再代入を検出して、なぜ再代入をすべきでないかをチームで共有するべきでしょう。そんなうっかりさんがいたらどんなコード書いてくるか気になって仕方ないので、しばらくペアプロしたい。検出に静的解析ツールを使ってもいいと思いますが、それは再代入を検出するべきで、finalが付いていないことを対象にはしません。

フィールドが final 付いてないからって再代入するようなのは、それをしちゃう考え方の方が危うい感じがします。また、再代入を行うフィールドが存在した場合、選択的に final を外すのも手間です。一度外したのを付け直すとかも面倒だし、そう言うときはコンパイルチェックがかからないから付け直し忘れとかが起こりうる。「なんでこれ final 付いてないんだっけ……」のような、答えGitのログにしか無いようなことに悩みたく無いです。

私の観測上、ローカル変数の使い回しが行われる主因は「汎用的な変数名」です。例えば str とか。適切な名前をつければ使い回しをする気なんて起きません。名付けの問題なのに「 final を付けてないから使い回しちゃうんだ、使い回せないように final をつけるルールにしよう」なんてするのは、臭いものの蓋ではないでしょうか。ルール敷いたところで str1 str2 とかが生まれるだけです。蓋の中でどんどん増殖しちゃう。

また、ローカル変数に final を付ける要因として先に挙げた「スコープが広い」がありますが、これは「狭くしましょう」としか言いようがありません。変数のスコープを狭くする。わかりやすくはメソッドの分割ですね。十分にスコープが狭ければ、「このローカル変数は再代入されたりしてないだろうか？」と疑う必要はありません。数行手前に目を走らせれば良いだけです。これも final を付けて対策としてはいけないものだと思うのです。

パラメータのfinal 不要も、メソッドが十分小さければ再代入なんてしたらすぐ違和感に気づくはず。そしてメソッドが十分に小さい、つまり文字数が少ない時に、パラメータやローカル変数に final が付いてたら、意味のない final の全体の文字数に対する割合が大きくなってしまう。

まあそんなわけで、実質的 final 、実質的イミュータブルで十分かなーって感じです。

それでも`final` にする場面

と言うのもあります。

フィールドは、そのクラスのインスタンスを自分の与り知らぬ誰かが使用する場合ですね。この記事の前提に反しますが、例えばライブラリなどを開発している場合です。まあ final にしたところで無理矢理変えることはできるんだけど、気休めは気が休まるので重要です。

パラメータやローカル変数は final 付いていようがなかろうがメソッドが十分小さくできてたら要らないと思う。対レガシーコードで手が出せなかったら事故防止のために付けるのを許容する、かも。

あとはチーム規模が大きくて（大きくするなよ）、誰がどんなコード書くかわからない（それもどうなの）……なんて時でしょうか。

まとめ

「final を付けるルール（暗黙含む）」によって、本来の問題が隠されてはいませんか？一回やめてみてもいいのではないでしょうか。私は今の所 final がないことによる問題には遭遇しておらず、コードの見通しがよくなったくらいです。 final を付けることで定数ならコンパイル時にインライン化されるなどのメリットはありますが、そういうのを考慮してもまあ要らないかなって。（とはいえ定数なら final 付けるけど、定数自体最近ほとんど使わないなぁ。）

最後になりますが、デフォルトで final がいいです。わざわざ書きたくない。再代入可能の方にだけ宣言したい。と言う願望で締めとします。

追記: `final`を付けるべきだと言う話 (2019-09-28T09:25)

私自身も final を付けるべきだと思ってたりもします。以下のようなのは大いに同意しますし、なんならそれを理由に「 final を付けるべきだ！」と言う役目を負ってもいいくらい。

読み手に変更する意思がないことを明示する

わかります。コードに意図を込めることは重要です。レビュアーや未来の自分を含め今後変更する際のコードを読む負荷を下げられるなら付けます。でも「よほどのことがない限り再代入なんてしない」なら、付けるほうが読む量増えるのに情報量が増えないので、やめてみました。

IDEが自動でつけるから書く手間はかからない

わかります。わざわざ final（スペース含め6文字）をタイプすることはないですし、変数宣言をIDEに生成させた時に自動でつくオプションもあります。とても便利。手間をすっ飛ばして残るのはやはり可読性。「 final をつけることでコードを読む速度が上がるか？」で、大体の場合答えはNO。なので、やめてみました。

ちなみに最近の私は、コードを書く手間は殆ど考慮していません。コードは読み物なんで、書く時の一瞬の負荷に振り回されるべきではないです。ふつうのJavaコーディングやコードをどまんなかになどをご参照ください。