.NET Core 環境建置

1 安裝 .NET Core SDK

安裝 .NET Core SDK 是開發 ASP.NET Core 應用程式的第一步。請根據作業系統選擇適合的版本：

Windows

1. 下載最新版本的 .NET Core SDK：官方下載連結

2. 執行安裝程式，選擇標準安裝方式。

3. 安裝完成後，開啟命令提示字元 (cmd) 或 PowerShell，輸入 dotnet --version 來確認安裝是否成功。

Linux (Ubuntu/Debian)

1. 更新套件管理器：

   sudo apt update && sudo apt upgrade -y

2. 安裝必要的相依性：

   sudo apt install -y dotnet-sdk-8.0

3. 驗證安裝是否成功：

   dotnet --version

MacOS

1. 使用 Homebrew 安裝：

   brew install dotnet-sdk

2. 驗證安裝是否成功：

   dotnet --version

2 設定開發工具

推薦使用的開發工具：

• Visual Studio 2022（適用於 Windows，用於完整開發環境）

• Visual Studio Code（輕量級編輯器，適用於 Windows / Mac / Linux）

• JetBrains Rider（適用於 Windows / Mac，提供強大 IntelliSense）

下載與安裝這些開發工具後，可透過 dotnet new console -o MyApp 來快速建立專案。

2 建立與管理 .NET Core 專案

1 建立 .NET Core 專案

要建立一個新的 .NET Core 專案，可以使用 dotnet new 命令。以下是一些常見的專案類型：

• 主控台應用程式：

  dotnet new console -o MyConsoleApp

• Web API 專案：

  dotnet new webapi -o MyWebApi

• Blazor 應用程式：

  dotnet new blazorserver -o MyBlazorApp

• 類別庫 (Library)：

  dotnet new classlib -o MyLibrary

這些命令會自動建立所需的專案結構與範例代碼。

2 設定與管理專案檔案

在建立專案後，專案目錄中會包含一個 .csproj 檔案，該檔案用於管理專案的組態、相依性與設定。例如，一個基本的 .csproj 檔案內容如下：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
  </PropertyGroup>
</Project>

3 執行與測試 .NET Core 專案

建立專案後，可以透過 dotnet run 來執行專案：

dotnet run

這將編譯並執行應用程式。

如果要進行單元測試，建議使用 xUnit，可以使用以下命令來建立測試專案：

dotnet new xunit -o MyTestProject

4 加入 NuGet 套件

在 .NET Core 中，透過 NuGet 可以安裝各種套件，例如 Entity Framework Core：

dotnet add package Microsoft.EntityFrameworkCore.SqlServer

可在 .csproj 中確認套件是否已成功安裝：

<ItemGroup>
  <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="8.0.0" />
</ItemGroup>

5 管理專案的相依性

使用 dotnet list package 可以列出所有已安裝的 NuGet 套件：

dotnet list package

如需移除某個套件，使用：

dotnet remove package Microsoft.EntityFrameworkCore.SqlServer

這些步驟確保了專案的相依性管理更加高效與可維護。

6 版本管理與 CI/CD 流程整合

在企業級專案中，確保版本管理的有效性至關重要。推薦使用 Git 進行版本控制，並且與 CI/CD (如 GitHub Actions、Azure DevOps、Jenkins) 整合。

Git 版本管理基本操作

1. 初始化 Git 儲存庫：

   git init
   git add .
   git commit -m "Initial commit"

2. 設定遠端儲存庫：

   git remote add origin https://github.com/your-repo.git
   git push -u origin main

3. 建立分支並切換：

   git branch feature-branch
   git checkout feature-branch

CI/CD 自動化部屬

在 CI/CD 流程中，確保程式碼自動測試與部署的執行，例如：

GitHub Actions YAML 配置範例

name: .NET Core CI/CD

on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v2
      - name: Setup .NET Core
        uses: actions/setup-dotnet@v1
        with:
          dotnet-version: 8.0.x
      - name: Restore dependencies
        run: dotnet restore
      - name: Build
        run: dotnet build --configuration Release --no-restore
      - name: Test
        run: dotnet test --no-restore --verbosity normal

這樣的自動化流程能夠確保程式碼的品質與穩定性，避免人工部署可能帶來的錯誤。

---