歡迎來到 C# → ASP.NET Core 系列的第一天。

這個系列會從 C# 基礎開始，逐步進入物件導向、資料處理、ASP.NET Core Web API、資料庫與部署，最後完成一個可以實際執行的後端專案。

大致的學習路線會是：

C# 基礎
   ↓
物件導向與資料處理
   ↓
ASP.NET Core Web API
   ↓
Database
   ↓
完整專案
   ↓
部署

第一天不需要急著理解太多語法。

今天最重要的事情只有一個：

準備好開發環境，並成功建立與執行第一個 C# 專案。

1. C# 與 .NET 是什麼？

開始寫程式之前，先認識兩個最基本的名詞：

• C#
• .NET

這兩個名稱之後會一直出現。

C#

C#（C Sharp）是一門程式語言。

我們會使用 C# 撰寫程式，例如：

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

C# 可以用來開發很多不同類型的應用程式，例如：

• Web API
• Web Application
• Desktop Application
• Cloud Service
• Background Service

這個系列主要會使用 C# 開發後端 ASP.NET Core Web API。

.NET

.NET 是開發與執行應用程式的平台。

可以先簡單理解成：

C# 程式語言
      ↓
.NET 開發與執行平台
      ↓
Application

換句話說：

C# 是我們撰寫程式時使用的語言，而 .NET 則提供建立、執行這些程式所需要的環境與工具。

現在不需要深入了解 .NET 的所有架構，只要先建立這個基本概念即可。

2. 準備 C# 開發環境

這個系列統一使用：

VS Code
+
C# Dev Kit
+
.NET 10 SDK

三者的用途如下：

接下來依序完成安裝。

2.1 安裝 VS Code

首先安裝 Visual Studio Code。

安裝完成後開啟 VS Code。

接著點選左側的：

Extensions

之後我們會在這裡安裝 C# 開發所需要的擴充套件。

2.2 安裝 C# Dev Kit

在 Extensions 搜尋：

C# Dev Kit

確認 Publisher 為：

Microsoft

接著安裝即可。

C# Dev Kit 主要會提供：

• C# 程式碼提示
• 專案管理
• Debug
• Testing
• C# 開發相關支援

第一天不需要額外安裝大量 Extension。

先保持開發環境單純，之後真的有需要再增加工具即可。

2.3 安裝 .NET 10 SDK

接著安裝：

.NET 10 SDK

SDK 全名是：

Software Development Kit

可以先理解成：

開發 .NET 應用程式所需要的一整套工具。

因為我們是要「開發」C# 程式，所以安裝 .NET SDK 即可開始。

.NET SDK 也包含開發時需要的 .NET Runtime。

安裝完成後，建議重新開啟 VS Code。

3. 確認 .NET SDK 是否安裝成功

接下來確認環境是否正確。

在 VS Code 開啟：

Terminal

輸入：

dotnet --version

如果看到類似：

10.0.xxx

代表 .NET SDK 已經正確安裝。

例如：

10.0.100

實際版本號可能會因為更新而不同，只要主要版本是 10 即可。

dotnet 是什麼？

這裡使用到的：

dotnet

是 .NET 提供的 Command-Line Interface（CLI）。

之後我們會經常使用它來：

建立專案
建置專案
執行專案
測試專案

今天先使用最基本的幾個指令：

dotnet --version
dotnet new
dotnet run

4. 建立第一個 C# 專案

環境準備完成後，正式建立第一個 C# 專案。

在 Terminal 輸入：

dotnet new console -n Day01

這行指令可以拆成：

dotnet new
↓
建立新的 .NET 專案

console
↓
使用 Console Application 範本

-n Day01
↓
專案名稱設定為 Day01

也就是：

使用 Console Application 範本，建立一個名為 Day01 的專案。

進入專案資料夾

建立完成後：

cd Day01

接著可以使用：

code .

就可以打開該專案資料夾囉。

5. 執行第一個 C# 專案

專案建立完成後，在 VS Code 的 Terminal 輸入：

dotnet run

第一次執行時，會看到：

Hello, World!

恭喜！

到這裡，你已經成功完成：

建立 C# Project
      ↓
執行 Project
      ↓
看到程式結果

這也是我們第一天最重要的目標。

6. 認識第一個 C# Project

建立並開啟 Day01 專案後，可以看到最基本的專案結構：

Day01
├── Day01.csproj
└── Program.cs

目前先認識這兩個檔案即可。

Program.cs

Program.cs

是目前 Console 專案主要撰寫與執行程式碼的地方。

打開後，可以看到類似：

Console.WriteLine("Hello, World!");

這就是剛才執行 dotnet run 時看到：

Hello, World!

Day01.csproj

Day01.csproj

是這個 C# Project 的專案設定檔。

裡面會包含：

• 使用的 .NET 版本
• 專案類型
• 編譯相關設定
• 套件資訊

目前不需要深入理解。

.csproj 與整個 Project 結構，會在 Day3 再詳細說明與介紹。

7. 寫下第一行 C#

現在打開：

Program.cs

將內容修改成：

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

這裡的：

Console.WriteLine()

目前可以先簡單理解成：

將指定的內容輸出到 Console。

所以：

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

就是：

在 Console 顯示 Hello, C#。

至於 Console 是什麼、WriteLine() 為什麼可以這樣呼叫，以及背後涉及的 Class、Method 等概念，之後會再逐步學習。

8. 再次執行程式

修改完成後，先記得儲存檔案。

接著回到 Terminal：

dotnet run

如果成功，就會看到：

Hello, C#

這代表剛才修改的 C# 程式已經成功執行。

9. 試著自己修改程式

接著把 Program.cs 改成：

Console.WriteLine("Hello, C#!");
Console.WriteLine("I'm learning C#.");
Console.WriteLine("Day 1 completed!");

再次執行：

dotnet run

結果：

Hello, C#!
I'm learning C#.
Day 1 completed!

你已經完成最基本的程式開發流程：

修改程式碼
     ↓
儲存
     ↓
執行
     ↓
查看結果

10. 今天使用到的指令

今天只需要先記住三個主要指令。

一、查看 .NET SDK 版本

dotnet --version

用途：

確認目前安裝的 .NET SDK 版本

二、建立 Console Project

dotnet new console -n Day01

用途：

建立一個名為 Day01 的 Console 專案

三、執行 Project

dotnet run

用途：

建立並執行目前的 .NET Project

Day 1 小結

今天我們先完成最基本的 C# 開發環境與執行流程。

三個重要概念：

今天最重要的完成開發環境與執行流程：

安裝開發環境
      ↓
建立 Project
      ↓
撰寫 C#
      ↓
dotnet run
      ↓
看到執行結果

如果你已經成功看到：

Hello, C#

那麼 Day 1 的目標就完成了。

那麼，我們 Day 2 見！