問題タブ [stylecop]

素晴らしい本「フレームワーク デザイン ガイドライン」(2008 年 11 月の第 2 版) の付録 A「C# コーディング スタイルの規則」を読んだ後、Microsoft が内部で使用している/推奨しているコーディング スタイルについてかなり混乱しています。

ブログ エントリA Brief History Of C# Styleは次のように主張しています。

実際、「StyleCop スタイル」と「フレームワーク デザイン ガイドライン スタイル」の違いは比較的小さいものです。

私が見る限り、違いはかなり顕著です。StyleCop では、開き括弧は別の行にある必要があると述べていますが、Framework Design Guidelines では、開きステートメントの後にある必要があります。StyleCop では、すべてのキーワードの後に​​スペースが必要であると規定されています。フレームワーク デザイン ガイドラインでは、「すべてのスペースを削除する」(2 項演算子の周りであっても) と規定されています。

フレームワーク設計ガイドラインの本から、このルールは特に皮肉だと思います (366 ページ、上から 6 番目のルール):

フロー制御ステートメントの前にスペースを使用しないでください

これは、StyleCop スタイルが間違っていることを明示的に示しています(while キーワードの後のスペース、等値二項演算子の前後のスペース)。

最後に、StyleCop スタイルを使用してフォーマットされたコードは、フレームワーク デザイン ガイドライン スタイルを使用してフォーマットされたコードとはまったく異なる "感触" を持っています。フレームワーク デザイン ガイドライン スタイルに従うことで、一連のルールを無効にする必要があります (フレームワーク デザイン ガイドライン スタイルへの準拠をチェックするルールはありません...)。

誰か (おそらく MSFT のインサイダー?) が、この相違点に光を当てることができますか?

あなたのチームはこれにどのように対処していますか? StyleCopをフォローしていますか？フレームワークの設計ガイドライン? スタイルを完全に無視しますか？あなた自身のスタイルを焼きますか？

インスピレーションを探しているだけです。特にパフォーマンスとセキュリティの分野では、命名規則は重要ですが、「かっこいい」ものではありません ;)

ルールがドメイン/プロジェクトにのみ適用され、ルールがどれほど強力であるかを示している場合でも、お知らせください。

私は C# を使用していますが、あらゆる言語のルールに興味があります。

StyleCop によって適用されるコア ルールをカプセル化したダウンロード可能なドキュメントはありますか?

C# に落ち着きました。FxCop と StyleCop を使用して、デザインとスタイルのガイドラインを適用します。人々がスピードアップするのを助けるために、カジュアルな読み物として参照資料の印刷版を手元に置いておきたいので、ルール参照の PDF 版があることを望んでいました.

これまでの StyleCop ルール リファレンスの検索は無駄でした。これらの規則が統合されたドキュメント (PDF、XPS、またはその他の単一のダウンロード可能な参照) として入手できるかどうかを誰かが知っている場合は、非常に感謝しています。

私が取り組んでいるプロジェクトのソース分析を有効にする方法について調査を行っており、StyleCop を使用する予定です。私が持っているセットアップは、TFS 継続的統合を使用したソース管理用の TFS サーバーです。開発者のマシンで実行されるものだけでなく、ビルド マシンで実行される CI ビルドとデイリー ビルドのソース分析を有効にしたいと考えています。

これは、件名で読んだ StyleCop のドキュメントの記事です: http://blog.newagesolution.net/2008/07/how-to-use-stylecop-and-msbuild-and.html。基本的に、目的に合わせて csproj ファイルを変更します。

また、StyleCop をビルド自動化と統合する方法についての他の意見も読みました。ビルド タスクを使用して同じことを行うことをお勧めします。

http://blog.newagesolution.net/2008/07/how-to-use-stylecop-and-msbuild-and.html http://freetodev.spaces.live.com/blog/cns!EC3C8F2028D842D5!400.entry .

あなたの意見は何ですか？同様のプロジェクトがあり、このようなことをしたことがありますか?

以前は、Visual Studio のプロジェクトで StyleCop + FxCop を使用していました。しかし今、MSBuild に簡単に統合できる Visual Studio コード分析ツールをテストしています。このツールは、FxCop と StyleCop の両方のルールの一部を分析することがわかりました。

このツールは FxCop と StyleCop の両方を完全に置き換えるものですか、それともそれらのルールの一部を実装するだけですか?

カスタム SytleCop ルールを単体テストするための最良の方法は何だろうと思っています。これを読みましたが、より良い解決策があることを願っています。

ありがとう。

私たちはちょうど StyleCop をチームに導入する作業を行っており、Code PlexのStyleCop ReSharper プラグインを使用しています。問題は、プロジェクト内のすべてのファイルが分析されているように見え、特定のファイルを除外する方法が見つからないことです。これには、プロジェクトに含まれる DBML またはサード パーティ コンポーネントの designer.cs ファイルなどのファイルが含まれます。これが意味することは、ReSharper でサイト全体のコード分析を行うと常にエラーが表示され、「グリーン」になることは決してないということです。

.csproj に入れることができる ExcludeFromStyleCop タグは常にありますが、これは MSBuild でのみ使用されます。ReSharper エラー ウィンドウでファイルを右クリックし、「エラーを無視する」ように指示しても機能しないようです。ウィンドウがリロードされるだけで、同じファイルが再度分析されます。

誰でもこれについて何か考えがありますか？

StyleCopを使用しています。this.ただし、たとえば、クラス メンバーの前で使用するなど、無視したいルールがいくつかあります。

StyleCop ルールをオフにするにはどうすればよいですか。私は見ましたが、それを行う方法を見つけることができません。

C# でコーディング標準を適用するために StyleCop を使用してきましたが、他の言語にも同様のツールがあるのではないかと考えていました。すなわち：

• js
• CSS
• SQL