C#スクリプトとは？初心者向けに実行方法・書き方・活用例をわかりやすく解説

はじめに

C#スクリプトは、C#を使って処理を記述し、ゲーム開発・自動化・学習・簡単な検証などに活用できるコードのことです。特にUnityを学び始めた人は、「C#スクリプトを作成してください」「スクリプトをアタッチしてください」といった言葉をよく目にします。

一方で、C#スクリプトという言葉は使われる場面によって少し意味が変わります。Unityではゲームオブジェクトの動きを制御するC#ファイルを指すことが多く、.NETの世界では.csxファイルのようにスクリプト形式で実行するC#コードを指すこともあります。

この記事では、初心者向けにC#スクリプトの意味、実行方法、基本的な書き方、活用例、よくあるエラーまでわかりやすく解説します。

1. C#スクリプトとは？初心者がまず知っておきたい基礎知識

1-1. C#スクリプトの意味と役割

C#スクリプトとは、C#というプログラミング言語で書かれた処理のまとまりです。画面に文字を表示したり、計算したり、ファイルを操作したり、Unity上でキャラクターを動かしたりできます。

「スクリプト」という言葉には、比較的小さな処理を記述して実行するコードという意味があります。C#スクリプトも同じように、何らかの動作をコンピューターに指示するためのものです。

たとえば、次のような処理をC#スクリプトで書けます。

C#
Console.WriteLine("こんにちは、C#スクリプト！");

このコードは、画面に「こんにちは、C#スクリプト！」と表示するだけの簡単な処理です。C#スクリプトの学習は、このような短いコードを動かすところから始めると理解しやすくなります。

1-2. C#とC#スクリプトの違い

C#はプログラミング言語の名前です。一方、C#スクリプトはC#で書かれたスクリプトやコードファイルを指します。

たとえるなら、C#は「日本語」や「英語」のような言語そのもので、C#スクリプトはその言語を使って書かれた「文章」や「手順書」のようなものです。

通常のC#プログラムでは、プロジェクトを作成し、複数のファイルを組み合わせてアプリケーションを作ります。C#スクリプトは、より小さな単位で処理を書いたり、Unityのような環境の中で特定の動作を担当したりする場面で使われます。

ただし、C#スクリプトも中身はC#です。そのため、変数、条件分岐、繰り返し、メソッド、クラスなど、基本的な文法は通常のC#と共通しています。

1-3. 「.cs」と「.csx」の違い

C#でよく使われるファイル拡張子には、.csと.csxがあります。

.csは、一般的なC#ソースコードファイルです。Visual Studioで作るコンソールアプリや、Unityで作るC#スクリプトの多くは.csファイルです。

PlayerController.cs
Program.cs
SampleScript.cs

一方、.csxはC#スクリプト用のファイルです。csiやdotnet-scriptなどのツールを使うと、.csxファイルをスクリプトのように実行できます。

sample.csx
tool.csx
test.csx

初心者の場合、Unityを使うならまず.csを覚えれば問題ありません。コマンドラインで短いC#コードを素早く試したい場合は、.csxを使う選択肢もあります。

1-4. UnityでいうC#スクリプトとは何か

UnityでいうC#スクリプトとは、ゲームオブジェクトの動きや処理を制御するためのC#ファイルです。

たとえば、プレイヤーをキーボードで動かす、敵を自動で移動させる、ボタンを押したときに画面を切り替える、アイテムを取得したときにスコアを増やす、といった処理をC#スクリプトで作ります。

UnityのC#スクリプトでは、MonoBehaviourというクラスを継承することが多いです。

C#
using UnityEngine;

public class PlayerController : MonoBehaviour
{
    void Start()
    {
        Debug.Log("ゲーム開始");
    }

    void Update()
    {
        Debug.Log("毎フレーム実行");
    }
}

Startはゲーム開始時などに一度実行され、Updateは毎フレーム繰り返し実行されます。Unityでは、このような仕組みを使ってゲーム内の動きを作っていきます。

1-5. C#スクリプトでできること

C#スクリプトでできることは幅広くあります。

Unityでは、キャラクターの移動、カメラ制御、当たり判定、UI操作、ゲームルールの実装などができます。通常のC#環境では、文字列処理、計算、ファイル操作、データ変換、簡単なツール作成、自動化処理などに使えます。

たとえば、次のような用途があります。

C#
int price = 1200;
int count = 3;
int total = price * count;

Console.WriteLine($"合計金額は{total}円です");

このように、C#スクリプトは「少し試したい処理」から「ゲームの本格的な動作」まで、さまざまな場面で役立ちます。

2. C#スクリプトが使われる主な場面

2-1. Unityのゲーム開発で使う

C#スクリプトがよく使われる代表的な場面は、Unityのゲーム開発です。Unityでは、オブジェクトにC#スクリプトを追加して動きを作ります。

たとえば、プレイヤーの移動処理は次のように書けます。

C#
using UnityEngine;

public class PlayerMove : MonoBehaviour
{
    public float speed = 5f;

    void Update()
    {
        float x = Input.GetAxis("Horizontal");
        float z = Input.GetAxis("Vertical");

        transform.Translate(new Vector3(x, 0, z) * speed * Time.deltaTime);
    }
}

このスクリプトをプレイヤーのオブジェクトにアタッチすると、キーボード入力に応じてオブジェクトを動かせます。

Unityでは、C#スクリプトを使ってゲームのほぼすべての動作を制御します。そのため、Unityを学ぶならC#スクリプトの基本は必ず押さえておきたい内容です。

2-2. 簡単な処理をすぐ試す

C#スクリプトは、短い処理をすぐ試したいときにも便利です。

たとえば、文字列を分割する処理、日付を計算する処理、リストを並べ替える処理などを確認したい場合、簡単なC#コードを書いて実行できます。

C#
string text = "apple,banana,orange";
string[] fruits = text.Split(',');

foreach (string fruit in fruits)
{
    Console.WriteLine(fruit);
}

このような短いコードを動かすことで、C#の文法や標準機能の使い方を確認できます。

2-3. 業務の自動化やツール作成に使う

C#スクリプトは、業務の自動化や小さなツール作成にも使えます。

たとえば、フォルダ内のファイル名をまとめて変更する、CSVファイルを読み込んで集計する、ログファイルから必要な情報だけを抜き出す、といった処理です。

C#
string[] files = Directory.GetFiles("logs");

foreach (string file in files)
{
    Console.WriteLine(Path.GetFileName(file));
}

手作業で行うと時間がかかる処理も、C#スクリプトにすれば短時間で繰り返し実行できます。

2-4. C#の文法学習や動作確認に使う

C#スクリプトは、C#の文法を学ぶときにも役立ちます。

最初から大きなアプリを作ろうとすると、プロジェクト構成やライブラリ、画面設計など覚えることが多くなります。まずは短いC#スクリプトを書いて、変数、条件分岐、繰り返し、メソッドなどを確認するのがおすすめです。

C#
int score = 85;

if (score >= 80)
{
    Console.WriteLine("合格です");
}
else
{
    Console.WriteLine("不合格です");
}

このような小さなコードを何度も書くことで、C#の基本が自然に身につきます。

2-5. 本格的なアプリ開発との使い分け

C#スクリプトは便利ですが、すべての開発に向いているわけではありません。

短い処理、検証用コード、学習用コード、Unity内の動作制御、小さな自動化には向いています。一方で、大規模なWebアプリ、業務システム、長期運用するアプリを作る場合は、通常のC#プロジェクトとして構成したほうが管理しやすくなります。

目安として、短く試すならC#スクリプト、本格的に作るならC#プロジェクトと考えるとわかりやすいです。

3. C#スクリプトを実行するために必要な環境

3-1. Unityで実行する場合に必要なもの

UnityでC#スクリプトを実行するには、Unity HubとUnity Editorが必要です。

Unity Hubは、Unityのバージョン管理やプロジェクト作成を行うためのツールです。Unity Editorは、実際にゲーム画面やオブジェクト、C#スクリプトを編集・実行するための開発環境です。

基本的な流れは、Unity Hubをインストールし、Unity Editorを追加し、新しいプロジェクトを作成して、C#スクリプトを作るという形になります。

Unityでは、C#スクリプトを書いたあと、ゲームオブジェクトにアタッチして実行します。単にファイルを作っただけでは動かないことが多いため、スクリプトをどのオブジェクトに割り当てるかが重要です。

3-2. Visual Studio・Visual Studio Codeで実行する場合に必要なもの

Visual StudioでC#コードを実行する場合は、Visual Studio本体とC#開発用のワークロードが必要です。コンソールアプリを作成すれば、C#コードを簡単に実行できます。

Visual Studio CodeでC#スクリプトやC#コードを書く場合は、Visual Studio Code本体に加えて、C#関連の拡張機能と.NET SDKを用意します。

Visual Studioは機能が豊富で初心者にも使いやすく、Visual Studio Codeは軽量でカスタマイズしやすいのが特徴です。

初心者が迷った場合、WindowsでC#をしっかり学ぶならVisual Studio、軽い環境で学びたいならVisual Studio Codeを選ぶとよいでしょう。

3-3. .NET SDKで実行する場合に必要なもの

コマンドラインからC#コードを実行するには、.NET SDKが必要です。

.NET SDKをインストールすると、dotnetコマンドが使えるようになります。これにより、C#のプロジェクト作成、ビルド、実行ができます。

たとえば、コンソールアプリを作る場合は次のように操作します。

Bash
dotnet new console -n SampleApp
cd SampleApp
dotnet run

dotnet new consoleは新しいコンソールアプリを作るコマンドです。dotnet runを実行すると、プロジェクト内のC#コードがビルドされて実行されます。

3-4. csiやdotnet-scriptを使う場合に必要なもの

C#をスクリプト形式で実行したい場合は、csiやdotnet-scriptを使う方法があります。

csiはC# Interactiveの実行環境で、C#のコードを対話的に実行できます。短いコードを試したいときに便利です。

dotnet-scriptは、.csxファイルをコマンドラインから実行できるツールです。インストール後、次のように実行できます。

Bash
dotnet script sample.csx

.csxファイルには、次のようにC#コードを書けます。

C#
Console.WriteLine("C#スクリプトを実行しました");

ただし、初心者は最初から.csxにこだわる必要はありません。まずはVisual StudioやUnityで.csファイルを使って学ぶほうが理解しやすいです。

3-5. 初心者におすすめの実行環境

初心者におすすめの環境は、目的によって変わります。

Unityでゲームを作りたいなら、UnityとVisual StudioまたはVisual Studio Codeの組み合わせがおすすめです。Unityの画面上でオブジェクトを動かしながら学べるため、結果が見えやすいです。

C#そのものを学びたいなら、Visual Studioでコンソールアプリを作る方法がおすすめです。プロジェクト作成から実行までがわかりやすく、エラー表示も確認しやすいです。

コマンド操作に慣れている人なら、.NET SDKとVisual Studio Codeを使う方法も向いています。軽量で、学習用の小さなコードを管理しやすいです。

4. C#スクリプトの実行方法

4-1. UnityでC#スクリプトを作成して実行する手順

UnityでC#スクリプトを作成して実行する基本手順は次のとおりです。

まず、Unityでプロジェクトを開きます。次に、Projectウィンドウで右クリックし、CreateからC# Scriptを選択します。ファイル名を入力すると、C#スクリプトが作成されます。

作成したスクリプトを開くと、次のようなコードが表示されます。

C#
using UnityEngine;

public class SampleScript : MonoBehaviour
{
    void Start()
    {
        
    }

    void Update()
    {
        
    }
}

Startの中に次のようなコードを書きます。

C#
void Start()
{
    Debug.Log("C#スクリプトが実行されました");
}

保存したら、Unityに戻り、スクリプトをゲームオブジェクトにドラッグ＆ドロップしてアタッチします。その後、再生ボタンを押すと、Consoleウィンドウにメッセージが表示されます。

4-2. Visual StudioでC#コードを実行する手順

Visual StudioでC#コードを実行するには、コンソールアプリを作るのが簡単です。

Visual Studioを起動し、新しいプロジェクトを作成します。テンプレートから「コンソールアプリ」を選び、プロジェクト名を入力して作成します。

Program.csに次のようなコードを書きます。

C#
Console.WriteLine("Visual StudioでC#を実行しました");

実行ボタンを押すと、コンソール画面に文字が表示されます。

Visual Studioでは、入力補完やエラー表示が充実しています。初心者がC#スクリプトの基本文法を学ぶには、とても使いやすい環境です。

4-3. Visual Studio CodeでC#スクリプトを実行する手順

Visual Studio CodeでC#コードを実行するには、.NET SDKをインストールし、C#関連の拡張機能を入れておきます。

ターミナルで次のコマンドを実行します。

Bash
dotnet new console -n SampleApp
cd SampleApp
code .

Visual Studio Codeが開いたら、Program.csを編集します。

C#
Console.WriteLine("VS CodeでC#を実行しました");

ターミナルで次のコマンドを実行します。

Bash
dotnet run

これでC#コードを実行できます。

Visual Studio Codeでは、エディタとターミナルを同じ画面で使えるため、コマンド操作に慣れると効率よく学習できます。

4-4. コマンドラインからC#スクリプトを実行する手順

コマンドラインからC#コードを実行する方法はいくつかあります。

一般的な方法は、.NET SDKでコンソールアプリを作って実行する方法です。

Bash
dotnet new console -n MyApp
cd MyApp
dotnet run

.csx形式のC#スクリプトを実行したい場合は、dotnet-scriptを使います。

Bash
dotnet tool install -g dotnet-script

その後、sample.csxを作成します。

C#
Console.WriteLine("csxファイルを実行しました");

次のコマンドで実行します。

Bash
dotnet script sample.csx

初心者は、まずdotnet new consoleとdotnet runを覚えるとよいでしょう。C#の基本を理解してから、.csxやスクリプト実行ツールに進むと混乱しにくくなります。

4-5. 実行できないときに確認すべきポイント

C#スクリプトが実行できないときは、まずエラーメッセージを確認します。

よくある原因は、.NET SDKがインストールされていない、dotnetコマンドにパスが通っていない、ファイル名やクラス名が間違っている、Unityでスクリプトをアタッチしていない、コードに文法ミスがある、といったものです。

特に初心者は、次の点を確認してください。

・保存してから実行しているか
・エラーがConsoleやターミナルに表示されていないか
・ファイル名とクラス名が一致しているか
・必要なusingを書いているか
・Unityならゲームオブジェクトにアタッチしているか

エラーは怖いものではなく、修正のヒントです。表示されたメッセージを読む習慣をつけると、解決が早くなります。

5. C#スクリプトの基本的な書き方

5-1. C#スクリプトの基本構成

通常のC#コードは、クラスやメソッドの中に処理を書きます。

C#
using System;

class Program
{
    static void Main()
    {
        Console.WriteLine("Hello C#");
    }
}

最近のC#では、コンソールアプリで次のように短く書ける場合もあります。

C#
Console.WriteLine("Hello C#");

Unityの場合は、次のような構成が基本です。

C#
using UnityEngine;

public class SampleScript : MonoBehaviour
{
    void Start()
    {
        Debug.Log("開始時に実行");
    }

    void Update()
    {
        Debug.Log("毎フレーム実行");
    }
}

Unityでは、StartやUpdateのような特別なメソッドがよく使われます。

5-2. 変数・型・演算子の書き方

変数は、値を入れておく箱のようなものです。C#では、変数に型があります。

C#
int age = 20;
double height = 170.5;
string name = "太郎";
bool isActive = true;

代表的な型は次のとおりです。

int    整数
double 小数
string 文字列
bool   trueまたはfalse

計算には演算子を使います。

C#
int a = 10;
int b = 3;

Console.WriteLine(a + b);
Console.WriteLine(a - b);
Console.WriteLine(a * b);
Console.WriteLine(a / b);
Console.WriteLine(a % b);

%は割り算の余りを求める演算子です。偶数・奇数の判定などでよく使います。

5-3. 条件分岐の書き方

条件によって処理を変えるには、if文を使います。

C#
int score = 75;

if (score >= 80)
{
    Console.WriteLine("よくできました");
}
else if (score >= 60)
{
    Console.WriteLine("合格です");
}
else
{
    Console.WriteLine("再挑戦しましょう");
}

ifの条件が正しい場合は、その中の処理が実行されます。条件が合わない場合は、else ifやelseの処理に進みます。

条件分岐は、ゲームでもアプリでも頻繁に使います。たとえば、HPが0以下ならゲームオーバー、スコアが一定以上ならクリア、入力が空ならエラー表示といった処理に使えます。

5-4. 繰り返し処理の書き方

同じ処理を何度も実行したいときは、繰り返し処理を使います。

代表的なのはfor文です。

C#
for (int i = 0; i < 5; i++)
{
    Console.WriteLine(i);
}

これは、0から4までの数字を表示します。

配列やリストの中身を順番に取り出す場合は、foreach文が便利です。

C#
string[] names = { "田中", "佐藤", "鈴木" };

foreach (string name in names)
{
    Console.WriteLine(name);
}

繰り返し処理は、一覧表示、データ集計、敵キャラクターの管理、ファイルの一括処理などでよく使われます。

5-5. メソッドの書き方

メソッドは、処理をひとまとまりにしたものです。同じ処理を何度も使いたいときや、コードを整理したいときに使います。

C#
void SayHello()
{
    Console.WriteLine("こんにちは");
}

このメソッドを呼び出すには、次のように書きます。

C#
SayHello();

値を受け取るメソッドも作れます。

C#
void Greet(string name)
{
    Console.WriteLine($"こんにちは、{name}さん");
}

Greet("太郎");

値を返すメソッドは、戻り値の型を指定します。

C#
int Add(int a, int b)
{
    return a + b;
}

int result = Add(3, 5);
Console.WriteLine(result);

メソッドを使うと、C#スクリプトが読みやすくなります。

5-6. コメントの書き方

コメントは、コードの説明を書くためのものです。実行時には無視されます。

1行コメントは//を使います。

C#
// 画面に文字を表示する
Console.WriteLine("Hello");

複数行コメントは/* */を使います。

C#
/*
ここは複数行のコメントです。
処理の説明をまとめて書けます。
*/

コメントは多すぎても読みにくくなります。コードを見ただけでは意図がわかりにくい部分に、補足として書くのがおすすめです。

5-7. 初心者がつまずきやすい書き方の注意点

C#スクリプト初心者がよくつまずくポイントは、セミコロン、波かっこ、型、大小文字の違いです。

C#では、多くの文の最後に;が必要です。

C#
Console.WriteLine("Hello");

また、Consoleとconsoleは別物として扱われます。C#は大文字と小文字を区別するため、名前を正確に書く必要があります。

波かっこ{}の対応も重要です。

C#
if (true)
{
    Console.WriteLine("実行されます");
}

波かっこが足りないと、コンパイルエラーになります。エディタの自動整形機能を使うと、構造を確認しやすくなります。

6. 初心者向けC#スクリプトのサンプルコード

6-1. 文字を表示するHello World

最初に試すサンプルとして定番なのが、Hello Worldです。

C#
Console.WriteLine("Hello World");

これは、画面に文字を表示するだけのコードです。

もう少しC#らしく書くと、次のようになります。

C#
using System;

class Program
{
    static void Main()
    {
        Console.WriteLine("Hello World");
    }
}

初心者は、まずこのコードを実行して、C#スクリプトがどのように動くのか確認しましょう。

6-2. 入力した値を計算するサンプル

次は、入力した値を使って計算するサンプルです。

C#
Console.Write("数値を入力してください: ");
string input = Console.ReadLine();

int number = int.Parse(input);
int result = number * 2;

Console.WriteLine($"入力した数値の2倍は{result}です");

Console.ReadLine()は、キーボードから入力された文字列を受け取ります。int.Parseは、文字列を整数に変換します。

ただし、数字以外を入力するとエラーになります。安全に処理したい場合は、int.TryParseを使います。

C#
Console.Write("数値を入力してください: ");
string input = Console.ReadLine();

if (int.TryParse(input, out int number))
{
    Console.WriteLine($"2倍は{number * 2}です");
}
else
{
    Console.WriteLine("数値を入力してください");
}

6-3. 条件分岐を使った判定サンプル

条件分岐を使うと、値によって結果を変えられます。

C#
int score = 72;

if (score >= 80)
{
    Console.WriteLine("評価: A");
}
else if (score >= 60)
{
    Console.WriteLine("評価: B");
}
else
{
    Console.WriteLine("評価: C");
}

このサンプルでは、点数によって評価を変えています。

Unityであれば、HPが0になったらゲームオーバーにする、アイテムを持っていれば扉を開ける、といった処理にも応用できます。

6-4. 繰り返し処理を使ったサンプル

繰り返し処理を使うと、同じ処理をまとめて実行できます。

C#
for (int i = 1; i <= 10; i++)
{
    Console.WriteLine($"{i}回目の処理です");
}

配列を使ったサンプルも見てみましょう。

C#
int[] scores = { 80, 65, 90, 70 };

int total = 0;

foreach (int score in scores)
{
    total += score;
}

double average = total / (double)scores.Length;
Console.WriteLine($"平均点は{average}です");

このコードでは、複数の点数を合計し、平均点を計算しています。

6-5. Unityでオブジェクトを動かすサンプル

Unityでオブジェクトを動かす簡単なC#スクリプトは次のとおりです。

C#
using UnityEngine;

public class MoveObject : MonoBehaviour
{
    public float speed = 3f;

    void Update()
    {
        float moveX = Input.GetAxis("Horizontal");
        float moveZ = Input.GetAxis("Vertical");

        Vector3 move = new Vector3(moveX, 0, moveZ);
        transform.Translate(move * speed * Time.deltaTime);
    }
}

このスクリプトをゲームオブジェクトにアタッチすると、キーボード入力で移動できます。

Time.deltaTimeを使うことで、フレームレートに左右されにくい移動になります。UnityでC#スクリプトを書くときは、Update内で毎フレーム処理する内容と、Startで最初に一度だけ行う処理を分けて考えることが大切です。

6-6. サンプルコードを改造して学ぶコツ

C#スクリプトを学ぶときは、サンプルコードをそのまま写すだけでなく、少しずつ改造することが大切です。

たとえば、Hello Worldなら表示する文字を変えてみます。計算サンプルなら、2倍ではなく3倍にしてみます。条件分岐なら、点数の基準を変更してみます。Unityの移動サンプルなら、移動速度や方向を変えてみます。

小さな変更を加えると、どのコードがどの動きに関係しているのか理解しやすくなります。

最初から完璧に書こうとする必要はありません。動かして、変えて、エラーを直す流れを繰り返すことで、C#スクリプトの力が身についていきます。

7. C#スクリプトの活用例

7-1. Unityでキャラクターを動かす

C#スクリプトの代表的な活用例は、Unityでキャラクターを動かす処理です。

プレイヤーの入力を受け取り、キャラクターの位置を変更することで移動を実現します。

C#
using UnityEngine;

public class CharacterMove : MonoBehaviour
{
    public float speed = 5f;

    void Update()
    {
        float x = Input.GetAxis("Horizontal");
        float y = Input.GetAxis("Vertical");

        Vector3 direction = new Vector3(x, y, 0);
        transform.position += direction * speed * Time.deltaTime;
    }
}

2DゲームならX軸とY軸、3DゲームならX軸とZ軸を使うことが多いです。キャラクター移動はUnity学習の基本なので、早い段階で試しておきたい処理です。

7-2. ボタン操作やイベント処理を作る

C#スクリプトは、ボタンを押したときの処理や、特定のイベントが発生したときの処理にも使えます。

たとえば、UnityのUIボタンを押したときにメッセージを表示する処理は次のように書けます。

C#
using UnityEngine;

public class ButtonSample : MonoBehaviour
{
    public void OnClickButton()
    {
        Debug.Log("ボタンがクリックされました");
    }
}

このメソッドをUnityのButtonコンポーネントに登録すると、クリック時に実行されます。

イベント処理は、ゲームだけでなくアプリ開発でも重要です。ユーザーの操作に応じて処理を動かす基本になります。

7-3. ファイル操作を自動化する

C#スクリプトは、ファイル操作の自動化にも使えます。

たとえば、指定したフォルダ内のテキストファイルを一覧表示する処理は次のように書けます。

C#
using System;
using System.IO;

class Program
{
    static void Main()
    {
        string folderPath = "data";

        if (Directory.Exists(folderPath))
        {
            string[] files = Directory.GetFiles(folderPath, "*.txt");

            foreach (string file in files)
            {
                Console.WriteLine(file);
            }
        }
        else
        {
            Console.WriteLine("フォルダが存在しません");
        }
    }
}

ファイル名の変更、コピー、削除、テキストの読み書きなどもC#で行えます。毎回手作業で行っている処理がある場合は、C#スクリプトで自動化できないか考えてみるとよいでしょう。

7-4. データの集計や変換に使う

C#スクリプトは、データの集計や変換にも向いています。

たとえば、数値のリストを合計する処理は次のように書けます。

C#
int[] sales = { 1200, 2500, 1800, 3000 };

int total = 0;

foreach (int sale in sales)
{
    total += sale;
}

Console.WriteLine($"売上合計: {total}円");

CSVファイルを読み込んで必要な列だけ取り出したり、文字列の形式を変換したりすることもできます。

業務でデータを扱う機会が多い人にとって、C#スクリプトは便利な補助ツールになります。

7-5. 簡単な検証用コードを書く

C#の機能やライブラリの動作を確認したいときにも、C#スクリプトは便利です。

たとえば、日付計算を確認したい場合は、次のようなコードを書けます。

C#
DateTime today = DateTime.Today;
DateTime nextWeek = today.AddDays(7);

Console.WriteLine($"今日: {today}");
Console.WriteLine($"7日後: {nextWeek}");

本番のアプリに組み込む前に、小さなコードで動作を確認しておくと、ミスを減らせます。

7-6. 自分用の小さな便利ツールを作る

C#スクリプトを使えば、自分用の小さな便利ツールも作れます。

たとえば、メモのテンプレートを生成する、連番のファイル名を作る、文字列を一括変換する、作業ログを保存する、といったツールです。

C#
string date = DateTime.Now.ToString("yyyy-MM-dd");
string fileName = $"memo_{date}.txt";

File.WriteAllText(fileName, "今日のメモ");
Console.WriteLine($"{fileName}を作成しました");

小さなツールを作る経験は、C#の理解を深める良い練習になります。実際に自分が困っている作業を自動化すると、学習のモチベーションも続きやすくなります。

8. C#スクリプトでよくあるエラーと解決方法

8-1. 「dotnet」コマンドが認識されない

コマンドラインでdotnetを実行したときに、コマンドが認識されない場合があります。

原因として多いのは、.NET SDKがインストールされていない、または環境変数のPATHが正しく設定されていないことです。

まず、次のコマンドを実行して確認します。

Bash
dotnet --version

バージョン番号が表示されれば、.NET SDKは使える状態です。表示されない場合は、.NET SDKをインストールし直すか、ターミナルを再起動してみてください。

インストール後にすぐ反映されないこともあるため、パソコンを再起動すると解決する場合もあります。

8-2. Unityでスクリプトが動かない

UnityでC#スクリプトが動かない場合、まずConsoleウィンドウにエラーが出ていないか確認します。

Unityでは、スクリプトにコンパイルエラーがあると、他のスクリプトも正常に動かないことがあります。赤いエラーが表示されている場合は、まずそれを修正しましょう。

また、スクリプトをゲームオブジェクトにアタッチしていない場合も動きません。Projectウィンドウにスクリプトファイルがあるだけでは実行されないため、対象のオブジェクトにドラッグ＆ドロップする必要があります。

StartやUpdateの名前を間違えている場合も注意が必要です。

C#
void Start()
{
    Debug.Log("開始");
}

startやStratのように書くと、Unityの特別なメソッドとして認識されません。

8-3. クラス名とファイル名が一致していない

Unityでは、C#スクリプトのファイル名とクラス名が一致していないと問題が起きることがあります。

たとえば、ファイル名がPlayerMove.csなら、クラス名もPlayerMoveにします。

C#
using UnityEngine;

public class PlayerMove : MonoBehaviour
{
    void Start()
    {
        Debug.Log("OK");
    }
}

次のようにファイル名とクラス名が違うと、スクリプトをアタッチできない原因になります。

C#
public class MovePlayer : MonoBehaviour
{
}

スクリプト名を変更したときは、ファイル名だけでなくクラス名も確認しましょう。

8-4. usingや参照設定が不足している

C#では、使いたい機能に応じてusingが必要になることがあります。

たとえば、ファイル操作をするにはSystem.IOを使います。

C#
using System.IO;

リストを使う場合は、System.Collections.Genericが必要です。

C#
using System.Collections.Generic;

Unityの機能を使う場合は、基本的に次のusingを書きます。

C#
using UnityEngine;

エラーで「型または名前空間の名前が見つかりません」と表示された場合は、usingが不足していないか確認しましょう。

8-5. コンパイルエラーの読み方

コンパイルエラーは、コードを実行する前に見つかる文法や型の間違いです。

エラーを見るときは、まず次の3つを確認します。

・どのファイルで起きているか
・何行目で起きているか
・どんな内容のエラーか

たとえば、セミコロンが足りない場合、次のようなコードはエラーになります。

C#
Console.WriteLine("Hello")

正しくは次のように書きます。

C#
Console.WriteLine("Hello");

エラーが出た行だけでなく、その直前の行に原因があることもあります。表示された行だけを見てわからない場合は、前後のコードも確認しましょう。

8-6. 初心者がエラーを解決するための確認手順

初心者がエラーを解決するときは、慌てず順番に確認することが大切です。

まず、エラーメッセージを読みます。次に、表示されたファイル名と行番号を確認します。その周辺のコードを見て、セミコロン、波かっこ、スペル、大文字小文字、型の違いをチェックします。

Unityの場合は、Consoleウィンドウの赤いエラーを上から順番に修正します。1つのエラーが原因で複数のエラーが表示されていることもあるため、最初のエラーから直すのが基本です。

修正したら保存し、もう一度実行します。この流れを繰り返すことで、エラーへの対応力がついていきます。

9. C#スクリプトを学ぶときのポイント

9-1. まずは短いコードを動かしてみる

C#スクリプトを学ぶときは、まず短いコードを動かしてみることが大切です。

最初から大きなアプリやゲームを作ろうとすると、わからないことが多すぎて挫折しやすくなります。まずは、文字を表示する、計算する、条件分岐を使う、繰り返し処理を使う、といった小さなコードから始めましょう。

C#
Console.WriteLine("C#スクリプトの学習を始めます");

短いコードでも、実際に動かすことで理解が深まります。

9-2. エラーを読みながら修正する

プログラミング学習では、エラーは必ず発生します。大切なのは、エラーを避けることではなく、エラーを読みながら修正する力をつけることです。

C#のエラーには、原因を示すヒントが含まれています。英語のメッセージでも、ファイル名、行番号、単語を手がかりにすると原因を見つけやすくなります。

エラーを1つ直すたびに、C#スクリプトへの理解は少しずつ深まります。

9-3. Unity目的ならUnityの基本操作も学ぶ

UnityでC#スクリプトを使いたい場合は、C#だけでなくUnityの基本操作も学ぶ必要があります。

スクリプトを書けても、ゲームオブジェクト、コンポーネント、Inspector、Prefab、Scene、Consoleなどの基本がわからないと、思ったように動かせません。

Unityでは、C#スクリプトをゲームオブジェクトにアタッチして使います。つまり、コードとUnity Editor上の設定が連動しています。

C#の文法とUnityの操作を並行して学ぶと、スクリプトの役割が理解しやすくなります。

9-4. アプリ開発目的ならC#の基礎文法を固める

アプリ開発を目的にC#を学ぶ場合は、まずC#の基礎文法をしっかり固めましょう。

特に、変数、型、条件分岐、繰り返し、配列、リスト、メソッド、クラス、例外処理は重要です。

本格的なアプリでは、コードの量が増えるため、基本文法の理解が不足していると途中でつまずきやすくなります。短いC#スクリプトで基本を練習し、その後にコンソールアプリ、デスクトップアプリ、Webアプリなどへ進むとスムーズです。

9-5. 作りたいものから逆算して学習する

C#スクリプトを効率よく学ぶには、作りたいものから逆算するのがおすすめです。

ゲームを作りたいなら、プレイヤー移動、当たり判定、UI、シーン切り替えを学びます。業務自動化をしたいなら、ファイル操作、文字列処理、CSV読み書き、日付処理を学びます。アプリを作りたいなら、クラス設計、データ管理、画面操作を学びます。

目的があると、必要な知識が明確になります。すべてを一度に覚えようとせず、作りたいものに必要なC#スクリプトから学んでいきましょう。

10. C#スクリプトに関するよくある質問

10-1. C#スクリプトは初心者でも学べる？

C#スクリプトは初心者でも学べます。

C#は型の指定や文法ルールがはっきりしているため、最初は少し難しく感じるかもしれません。しかし、ルールが明確なので、慣れると読みやすく書きやすい言語です。

初心者は、まず短いコードを動かすことから始めましょう。いきなり複雑なゲームやアプリを作るのではなく、文字表示、計算、条件分岐、繰り返し処理を順番に学ぶのがおすすめです。

10-2. C#スクリプトとJavaScriptは何が違う？

C#スクリプトとJavaScriptは、名前に「スクリプト」と付くことがありますが、別の言語です。

C#は、Unity、デスクトップアプリ、Webアプリ、業務システムなどで使われるプログラミング言語です。型が明確で、大規模な開発にも向いています。

JavaScriptは、主にWebブラウザ上で動く言語として広く使われています。Webサイトの動きや、フロントエンド開発でよく使われます。

Unityでゲームを作るならC#、Webページに動きをつけるならJavaScriptというように、目的によって使い分けます。

10-3. C#スクリプトだけでアプリは作れる？

簡単なツールやコンソールアプリであれば、C#スクリプトに近い形で作れます。

ただし、本格的なアプリを作る場合は、C#スクリプトだけでなく、プロジェクト構成、画面設計、データ保存、ライブラリ、エラー処理なども必要になります。

学習の最初はC#スクリプトで短い処理を書き、慣れてきたらC#プロジェクトとしてアプリを作る流れがおすすめです。

10-4. Unityを使わなくてもC#スクリプトは実行できる？

Unityを使わなくてもC#スクリプトやC#コードは実行できます。

Visual Studioでコンソールアプリを作る方法、Visual Studio Codeと.NET SDKを使う方法、dotnet-scriptで.csxファイルを実行する方法などがあります。

UnityはC#スクリプトの代表的な利用環境ですが、C#そのものはUnity専用ではありません。業務システム、Webアプリ、デスクトップアプリ、ツール開発など、さまざまな分野で使われています。

10-5. 最初に覚えるべき文法はどれ？

最初に覚えるべき文法は、変数、型、条件分岐、繰り返し、メソッドです。

まずは次の内容を順番に学ぶとよいでしょう。

・Console.WriteLineで文字を表示する
・intやstringなどの変数を使う
・if文で条件分岐する
・for文やforeach文で繰り返す
・メソッドで処理をまとめる
・配列やリストで複数の値を扱う

Unityを学ぶ場合は、これに加えてStart、Update、transform、Input、Debug.Logなども早めに覚えると役立ちます。

まとめ

C#スクリプトとは、C#で書かれた処理のまとまりであり、Unityのゲーム開発、C#の学習、業務の自動化、簡単なツール作成など幅広い場面で活用できます。

Unityでは、C#スクリプトをゲームオブジェクトにアタッチして、キャラクターの移動やイベント処理を作ります。Visual StudioやVisual Studio Code、.NET SDKを使えば、Unityを使わずにC#コードを実行することもできます。

初心者は、まず短いコードを動かすことから始めましょう。文字を表示する、計算する、条件分岐を使う、繰り返し処理を書く、といった基本を積み重ねることで、C#スクリプトの理解が深まります。

エラーが出たときは、ファイル名、行番号、エラーメッセージを確認しながら少しずつ修正していくことが大切です。C#スクリプトは、実際に書いて動かすほど身につきます。

ゲームを作りたい人はUnityの基本操作と一緒に、アプリやツールを作りたい人はC#の基礎文法と.NETの使い方を学びながら、自分の目的に合わせてC#スクリプトを活用していきましょう。