c# - Arrange-Act-Assert で単体テストを行う場合、見出しのコメントは推奨されますか?

Question

AAA パターンで提案されているように、単体テストのステートメントを分割するという概念が役立つと思います。

テストが次のようになるように、見出しコメントを追加する傾向があります。

// Arrange
int a = 1;
int b = 2;

// Act
int c = a + b;

// Assert
Assert.AreEqual(3, c);

しかし、私は興味があります.これらのヘッダーコメントを常に含めるのは普通ですか?

...またはこれは私が避けるべきものですか?

int a = 1;
int b = 2;

int c = a + b;

Assert.AreEqual(3, c);

Answer 1

基本的な前提が理解されると、それはあまり価値がないように思われます。C# について言及されているので、例としてThe Art of Unit Testingをご覧になることをお勧めします。単体テストに正しく名前を付けることは、コメントを配置/動作/アサートするよりも重要です。この本が指摘しているように、テストが失敗した場合、適切な名前が付けられていれば、最近行われた変更を知っていれば、多くの場合、回帰の原因を直接推測できます。