ステップ数のカウントツールを使うことで、手作業では膨大な時間がかかるコード行数の計測を自動化・効率化することができます。
LOC(Lines of Code)の自動計測は、開発規模の把握・工数見積もり・プロジェクト管理における客観的なデータ収集に欠かせない作業です。
どのツールを選べばよいか・どのように使うか・計測結果をどう読み取るかを理解しておくことは、開発現場でもポートフォリオ作成でも役立つ実践的な知識でしょう。
この記事では、ステップ数のカウントツールの種類・自動計測の方法・目安となる数値の読み方まで、わかりやすく丁寧に解説していきます。
ステップ数のカウントツールとは?自動計測の基本と必要性
それではまず、ステップ数のカウントツールの基本的な概念と自動計測の必要性について解説していきます。
ステップ数のカウントツールとは、ソースコードを自動的に解析してコードの行数(LOC)を計測するソフトウェアのことです。
手作業でコードの行数を数えることは、小規模なプログラムであれば可能ですが、数千〜数万行に及ぶ実務レベルのコードでは現実的ではありません。
カウントツールを使うことで、プロジェクト全体のコード量を短時間で正確に把握できるのです。
自動計測ツールが必要とされる主な場面は以下のとおりです。
開発規模の見積もり・プロジェクト進捗の把握・チームの生産性評価・ポートフォリオのステップ数確認などが代表的な用途として挙げられます。
特にSIer・受託開発・大規模システム開発の現場では、ステップ数を工数見積もりの基礎データとして活用するため、正確な計測ツールの利用が欠かせません。
カウントツールが計測する主な指標
ステップ数カウントツールが出力する主な指標を整理しておきましょう。
| 指標名 | 意味 |
|---|---|
| Total Lines(総行数) | ファイル内のすべての行数 |
| Code Lines(コード行数) | 実際の処理コードの行数(空行・コメント除く) |
| Comment Lines(コメント行数) | コメントのみの行数 |
| Blank Lines(空行数) | 空白のみの行数 |
| ファイル数 | 対象ディレクトリ内のファイル総数 |
ツールによって出力される指標の種類や名称が異なりますが、Code Linesがいわゆる論理ステップ数に相当することが多いです。
用途に合わせてどの指標を参照するかを判断することが重要でしょう。
代表的なステップ数カウントツールの種類と特徴
続いては、実際によく使われるステップ数カウントツールの種類と特徴について確認していきましょう。
cloc(Count Lines of Code)
clocは、最も広く使われているオープンソースのLOCカウントツールのひとつです。
コマンドラインで動作し、100以上のプログラミング言語に対応しているため、Webアプリ・組込み系・データ分析など幅広い種類のプロジェクトに使用できます。
cloc .(カレントディレクトリ全体を計測)
cloc src/(特定のディレクトリを計測)
cloc main.py(特定のファイルを計測)
出力例:
Language files blank comment code
Python 5 120 80 600
JavaScript 3 60 40 350
SUM: 8 180 120 950
言語ごとにコード行数・コメント行数・空行数が一覧で表示されるため、プロジェクト全体の構成を素早く把握できます。
Windowsではインストーラー版、MacやLinuxではHomebrewやパッケージマネージャーから簡単にインストールできるでしょう。
CLOC for VS Code(VSCode拡張機能)
Visual Studio Codeを使用している開発者には、VSCodeの拡張機能としてステップ数を計測できるツールが複数提供されています。
代表的なものにはVS Code Counter・cloc for VS Codeなどがあり、エディタ上で右クリックするだけでディレクトリやファイルのLOCを計測できます。
コマンドラインに不慣れな初心者でも直感的に使えるため、個人開発やポートフォリオのステップ数確認に特に便利でしょう。
tokei
tokeiはRust製の高速LOCカウントツールであり、大規模プロジェクトでも高速に計測できる点が特徴です。
clocと同様にコマンドラインで使用し、多くのプログラミング言語に対応しています。
出力が見やすい表形式で表示されるため、結果の読み取りが直感的でしょう。
Understand
UnderstandはGUI操作が可能な商用の静的解析ツールであり、LOCの計測に加えてコードの複雑度・依存関係・ドキュメント生成など高度な機能を持ちます。
大規模な業務システム・組込みソフトウェアの品質管理に使われることが多く、詳細なレポート出力が必要なプロジェクトに適しています。
無料トライアル版も提供されているため、業務利用を検討する際に試してみる価値があるでしょう。
各ツールの比較まとめ
| ツール名 | 動作環境 | 費用 | 主な用途 |
|---|---|---|---|
| cloc | CLI(Win/Mac/Linux) | 無料 | 汎用・個人・業務 |
| VS Code Counter | VSCode拡張 | 無料 | 個人開発・学習 |
| tokei | CLI(Win/Mac/Linux) | 無料 | 大規模プロジェクト |
| Understand | GUI(Win/Mac/Linux) | 有料(試用版あり) | 業務・品質管理 |
clocを使ったステップ数の自動計測の方法・手順
続いては、最も汎用的なclocを使ったステップ数の自動計測の具体的な手順について確認していきましょう。
clocのインストール方法
clocのインストール方法は使用するOSによって異なります。
①GitHubのclocリリースページからcloc.exeをダウンロード
②任意のフォルダに配置してパスを通す、またはそのフォルダで実行
Macの場合(Homebrew使用):
brew install cloc
Ubuntuの場合:
sudo apt install cloc
インストール後にターミナル(コマンドプロンプト)で「cloc –version」と入力してバージョンが表示されれば、正常にインストールされています。
基本的な計測コマンド
clocの主要なコマンドオプションを覚えておくと、さまざまな計測シーンに対応できます。
cloc . → カレントディレクトリ全体を計測
cloc src/ → srcフォルダ内を計測
cloc –exclude-dir=node_modules . → 特定フォルダを除外して計測
cloc –include-lang=Python . → 特定言語のみ計測
cloc –csv –out=result.csv . → 結果をCSVファイルに出力
node_modulesやvenvなどの依存パッケージフォルダを除外することが重要であり、自分が書いたコードのみを正確に計測するためには除外設定を活用しましょう。
計測結果の読み方
clocの出力結果の読み方を確認しておきましょう。
Language → プログラミング言語の種類
files → ファイルの数
blank → 空行数
comment → コメント行数
code → 実際のコード行数(論理ステップ数に相当)
SUM → 全言語の合計
ポートフォリオや就活でステップ数を記載する際は、codeの合計値(SUM: code)を使うのが一般的です。
total linesではなくcode linesを参照することで、空行やコメントを除いた実質的なコード量を正確に示せます。
ステップ数の計測結果の目安・プロジェクト管理への活用
続いては、計測したステップ数の目安となる読み方と、プロジェクト管理への活用方法について確認していきましょう。
プロジェクト規模とステップ数の目安
計測したステップ数がどの程度の規模に相当するかを判断する目安を整理します。
| 規模の分類 | ステップ数の目安 | 開発例 |
|---|---|---|
| 超小規模 | 〜500ステップ | 練習用スクリプト・小ツール |
| 小規模 | 500〜5,000ステップ | 個人開発Webアプリ・課題制作 |
| 中規模 | 5,000〜50,000ステップ | 業務システム・中規模Webサービス |
| 大規模 | 50,000〜500,000ステップ | エンタープライズシステム |
| 超大規模 | 500,000ステップ以上 | OS・大規模プラットフォーム |
参考として、Linuxカーネルは数千万ステップ・AndroidOSは数億ステップ規模とされており、規模感の比較として参考になるでしょう。
プロジェクト管理でのステップ数活用
プロジェクト管理においてステップ数を活用する方法として、定期的な計測による進捗把握が効果的です。
スプリントや週単位でステップ数を計測してグラフ化することで、開発ペースの可視化・遅延の早期発見に役立てられます。
・定期計測:週次または月次でLOCを計測し推移をグラフ化する
・生産性計算:ステップ数÷工数で1人日あたりの生産性を算出する
・品質管理:バグ数÷ステップ数でバグ密度を計算して品質評価に使う
・見積もり精度向上:実績ステップ数を蓄積して次回見積もりの精度を高める
・ただしステップ数のみを目標にするとコードの冗長化を招くため注意が必要
ステップ数計測の注意点
ステップ数の計測と活用においていくつかの重要な注意点があります。
まず、自動生成コードは除外することが原則です。
フレームワークやツールが自動生成したコード(マイグレーションファイル・設定ファイルなど)を含めると、実際の開発量を正確に反映しません。
次に、ステップ数を開発者の評価指標として使いすぎると、無駄にコードを長くするインセンティブが生じる危険性があることも覚えておきましょう。
まとめ
この記事では、ステップ数カウントツールの種類(cloc・VS Code Counter・tokei・Understand)・clocを使った自動計測の具体的な手順・計測結果の読み方・プロジェクト管理への活用方法まで幅広く解説しました。
最も手軽で汎用的なツールはclocであり、「cloc .」の1コマンドでプロジェクト全体のコード行数を言語別に計測できます。
計測結果のcode列(論理ステップ数)を参照し、node_modulesなどの自動生成コードを除外することが正確な計測のポイントです。
ステップ数はプロジェクト管理・見積もり・ポートフォリオ作成に有用な指標ですが、コードの品質や難易度は反映されないため他の指標と組み合わせて活用することが大切でしょう。