#1 C#で学ぶ環境構築の基本

C#はMicrosoftが開発したプログラミング言語で、Windowsアプリからゲーム開発(Unity)、Webサービス、スマホアプリまで幅広い分野で使われています。かつては「Windowsでしか動かない言語」というイメージが強くありましたが、現在はMac・Linuxでも同じように学習できる環境が整っています。この記事では、C#の環境構築を、実際につまずきやすいポイントやエラー対処も含めて詳しく解説します。

.NET SDKのインストール

C#を動かすには、「.NET SDK」という開発キットをインストールします。SDKとは「Software Development Kit」の略で、プログラムを書くために必要な道具一式(コンパイラや実行環境など)がまとめて入っている箱のようなものです。公式サイト(dotnet.microsoft.com)からOSに合ったインストーラーをダウンロードして実行するだけで準備が整います。

インストール後、次のコマンドでバージョンを確認しましょう。

dotnet --version

ここで数字(例: 8.0.100 など)が表示されれば成功です。もし何も表示されず、後述のようなエラーが出た場合は、次のセクションを参考にしてください。

プロジェクトを作って実行する

C#では、フォルダを作成したあと次のコマンドで新しいプロジェクトのひな形を作成します。

dotnet new console

これだけで、すぐに動かせるサンプルコードとプロジェクトの設定ファイル(拡張子が「.csproj」のファイル)が自動生成されます。この.csprojファイルは、いわば「このプロジェクトの説明書」で、使っている.NETのバージョンや外部ライブラリの情報が書かれています。中身を無理に理解する必要はありませんが、「プロジェクトごとに1つ存在する設定ファイル」という程度に覚えておくと、後々エラーの原因を探るときに役立ちます。

実行するときは、そのフォルダで次のコマンドを使います。

dotnet run

画面に「Hello, World!」と表示されれば、環境構築は完了です。

よくあるエラーと対処法

環境構築でつまずくときは、たいてい決まったパターンのエラーに遭遇します。実際によく見るメッセージと、その原因・対処法をまとめました。

「'dotnet' is not recognized as an internal or external command」「dotnet: command not found」

Windowsでは前者、Mac・Linuxでは後者のようなメッセージが出ることがあります。これは「dotnetというコマンドがどこにあるか、パソコンが認識できていない」状態です。原因のほとんどは、インストール後にターミナル(コマンドプロンプトやPowerShell)を再起動していないことです。インストーラーがPATH(コマンドの場所を示す設定)を通してくれるのですが、それを反映するには一度ターミナルを閉じて開き直す必要があります。それでも直らない場合は、インストール自体が完了していない可能性があるので、公式サイトから再インストールを試してください。

SDKのバージョンが合わずビルドできない

「The current .NET SDK does not support targeting .NET 8.0」のようなメッセージが出ることがあります。これは、プロジェクトが要求している.NETのバージョンと、実際にインストールされているSDKのバージョンがずれていることが原因です。dotnet --list-sdksで今入っているSDKの一覧を確認し、公式サイトから該当バージョン(またはそれ以上)をインストールすれば解決します。学習用途では、基本的に最新のLTS(長期サポート)版を入れておけば困ることはあまりありません。

Visual Studioのインストールに時間がかかる・止まって見える

Visual Studioは非常に多機能なぶん、インストーラーのダウンロードサイズが大きく、環境によっては30分〜1時間程度かかることがあります。進捗バーが途中で止まって見えても、多くの場合は裏側でファイルの展開やコンポーネントの設定が進んでいるだけなので、極端に長時間(1時間以上)動きがない場合を除いては、そのまま待つのがおすすめです。インストール時に選択する「ワークロード」は、C#の学習だけであれば「.NETデスクトップ開発」を選んでおけば十分です。

ビルドは通るのに実行時にエラーが出る

コードの文法自体は正しいのに、実行した瞬間に赤いエラーメッセージ(例外)が出ることがあります。これは文法ミスではなく、プログラムの「動かし方」に問題があるケースがほとんどです。エラーメッセージには原因のヒントが書かれているので、慣れないうちは焦らず、メッセージをそのまま検索してみるのも有効な手段です。

つまずきやすいポイント・よくある質問(FAQ)

Q. Visual StudioとVisual Studio Code、どちらを使えばいいですか?

名前が似ていますが、性質の異なるソフトです。Visual Studioは統合開発環境(IDE)と呼ばれ、C#の開発に必要な機能(デバッガー、UIデザイナーなど)が最初からまとまって入っている、いわば「フル装備の作業場」です。一方Visual Studio Codeは軽量なテキストエディタで、拡張機能を追加することでC#開発にも対応できます。目安として、Windowsでガッツリ本格的に学びたい場合はVisual Studio、まずは軽く触ってみたい・Mac/Linuxでも使いたい場合はVisual Studio Code、という選び方をしている人が多い印象です。どちらが正解ということはなく、好みや環境で選んで問題ありません。

Q. ".NET Framework"と"Microsoft .NET"(いわゆる.NET 5以降)は何が違うのですか?

調べ物をしていると、この2つの名前が混在していて混乱しやすいポイントです。ざっくり言うと、.NET Frameworkは古くからあるWindows専用の仕組みで、現在は新規開発ではあまり使われなくなっています。一方、現在主流となっている「.NET」(バージョン5以降、名前から「Framework」や「Core」が外れたもの)は、Windows・Mac・Linuxのどれでも動くように作り直された新しい仕組みです。この記事で案内している.NET SDKは、後者の最新の.NETを指しています。ネット上の古い記事を参考にする際は、どちらの話をしているか少し意識すると混乱を避けられます。

Q. 結局、最初のエディタは何を使えばいいですか?

断定はできませんが、初めてで環境構築自体に不安がある場合は、Visual Studioの無料版(Community Edition)を素直にインストールしてしまうのも一つの手です。プロジェクトの作成や実行ボタンがあらかじめ用意されているため、コマンド操作に慣れる前でも迷いにくい構成になっています。慣れてきたら、軽快に動くVisual Studio Codeへ乗り換える、という流れを取る人も多いようです。

C#ならではの注意点と、他言語との考え方の違い

C#は元々Windows専用の技術という歴史的経緯があり、古い情報の中には「Windowsでしか動かない」という説明も見られます。しかし現在の.NETはクロスプラットフォーム化されており、Mac・Linuxでも同じコードが動きます。学習時に情報を調べる際は、記事の書かれた時期にも注意しておくと混乱を避けられます。

また、C#の環境構築は「SDKをインストールし、コマンド一つでプロジェクトの雛形を作る」という流れが一本化されているのが特徴です。言語によっては、実行環境とは別にパッケージ管理ツールやビルドツールを個別にインストールする必要があるものもありますが、C#(.NET)の場合はSDKの中にそれらの機能がまとめて含まれているため、追加でインストールするものが比較的少なく済みます。この「最初の一歩がまとまっている」という点は、これから環境構築を学ぶ人にとってはありがたいポイントと言えるでしょう。もちろん、どの言語にもそれぞれの合理的な設計思想があり、優劣をつけるものではありません。

まとめ

C#の環境構築は、.NET SDKをインストールしdotnet new consoleでプロジェクトを作るだけの手軽な流れです。つまずいたときの多くは、PATHが通っていない、SDKのバージョンが合っていない、といった決まったパターンに当てはまるので、慌てずにエラーメッセージを確認すれば解決できることがほとんどです。Windows専用という古いイメージにとらわれず、まずは気軽にdotnet runを試してみましょう。

本ページはプロモーションを含みます。

参考書籍(PR)

C#をもっと学びたい方には「確かな力が身につくC#「超」入門 第2版」がおすすめです。

コメント

コメントを投稿

このブログの人気の投稿

#11 Rustで学ぶエラーハンドリングの基本

Rustのエラーハンドリングは、他の言語のような「例外」という仕組みを持たず、`Result`という型を使った独自の考え方が中心になります。この記事では、Rustにおけるエラーハンドリングの基本を解説します。 Result型という考え方 失敗する可能性がある処理は、`Result`という「成功か失敗かを表す型」を返します。 fn divide(a: i32, b: i32) -> Result<i32, String> { if b == 0 { return Err(String::from("0では割れません")); } Ok(a / b) } 成功時は`Ok`、失敗時は`Err`という形で結果を包んで返します。 matchで結果を扱う match divide(10, 0) { Ok(result) => println!("結果: {}", result), Err(message) => println!("エラー: {}", message), } ?という便利な記号 Rustには、`Result`がエラーだった場合に、その場で関数の呼び出し元にエラーを伝えて処理を中断できる`?`という記号があります。 fn calculate() -> Result<i32, String> { let result = divide(10, 0)?; Ok(result) } Rustならではの注意点 他の言語の「エラーが起きても気づかずに進んでしまう」という問題を防ぐため、Rustは`Result`の中身を確認しない限り、警告を出す仕組みになっています。エラーの可能性を無視できない設計こそが、Rustの安全性を支えています。 まとめ Rustのエラーハンドリングは`Result`型が中心で、`match`や`?`を使って結果を扱います。エラーの可能性を無視できない設計に慣れていきましょう。 本ページはプロモーションを含みます。 参考書籍(PR) Rustをもっと学びたい方には「 実践Rust入門[言語仕様から開発手法まで] 」がおすすめです。...
続きを読む

#16 TypeScriptで学ぶ辞書型(マップ)の基本

TypeScriptの辞書に相当する仕組みは、JavaScriptと同じですが、キーと値の型をあらかじめ決めておけるのが特徴です。この記事では、TypeScriptにおける辞書の扱い方を解説します。 型付きのオブジェクト interface Person { name: string; age: number; } const person: Person = { name: "太郎", age: 20 }; キーの型が決まっていない辞書 キーの名前が事前に決まっていない辞書のような使い方をしたい場合は、次のように書きます。 const scores: { [key: string]: number } = {}; scores["太郎"] = 90; Mapを使う場合 const person = new Map<string, string>(); person.set("name", "太郎"); `Map<string, string>`のように、キーと値それぞれの型を指定できます。 TypeScriptならではの注意点 型付きのオブジェクト(`interface`)を使うと、存在しないキーにアクセスしようとした際に、実行前の段階でエラーとして教えてもらえます。データの形が決まっている場合は、キーが自由な辞書よりも`interface`を使うほうが安全です。 まとめ TypeScriptの辞書は、形が決まっているなら`interface`、自由なキーを扱うなら`{ [key: string]: 型 }`や`Map`を使います。用途に応じて型の付け方を選びましょう。 本ページはプロモーションを含みます。 参考書籍(PR) TypeScriptをもっと学びたい方には「 プロを目指す人のためのTypeScript入門 」がおすすめです。
続きを読む

#19 Goで学ぶテスト(単体テスト)の基本

Goはシンプルな文法が魅力ですが、書いたコードが正しく動くかどうかは別問題です。この記事では、Goで書いたコードを自動でチェックする「テスト」の基本を解説します。 なぜテストを書くのか コードを修正するたびに、関連する機能が壊れていないかを手作業で確認するのは大変です。テストを用意しておけば、コマンド一つで動作確認ができ、安心してコードを直せるようになります。 Go標準のテスト機能 Goには追加のライブラリを入れなくても使える testing パッケージが標準で備わっています。テスト対象のファイルと同じディレクトリに、名前の末尾が _test.go のファイルを作ります。 // add.go package main func add(a int, b int) int { return a + b } // add_test.go package main import "testing" func TestAdd(t *testing.T) { result := add(2, 3) if result != 5 { t.Errorf("add(2, 3) = %d; want 5", result) } } テスト関数の名前は Test から始める決まりです。ターミナルで go test と実行すると、 _test.go 内の Test から始まる関数がすべて自動で実行されます。 複数パターンをまとめてテストする Goでは、複数の入力パターンをスライス(配列のようなもの)にまとめて、まとめてテストする書き方(テーブル駆動テスト)がよく使われます。 func TestAddCases(t *testing.T) { cases := []struct{ a, b, want int }{ {2, 3, 5}, {0, 0, 0}, {-1, 1, 0}, } for _, c := range cases { if got := add(c.a, c.b); got != c.want { t.Errorf("add(%d,...
続きを読む