C# 建立捷徑完整指南：使用 WSH 實現桌面捷徑建立

對於大多數 Windows 使用者來說，建立捷徑是輕而易舉的基本操作，但對程式開發人員而言，在 .NET 環境下要為應用程式自動建立捷徑卻並非直觀簡單。.NET Framework 本身並未提供直接建立 .lnk 檔案的內建方法，這時我們可以借助 Windows Script Host (WSH) 來達成目標。

捷徑檔案的本質與構成

捷徑本質上是一個副檔名為 .lnk 的特殊檔案。當你右鍵點選捷徑並選擇「內容」切換到「捷徑」分頁時，可以看到一個捷徑包含以下核心資料：

• 捷徑的顯示名稱
• 目標檔案所在的完整路徑
• 目標程式的工作目錄
• 啟動熱鍵設定
• 視窗顯示模式（一般、最大化、最小化）
• 描述性文字
• 圖示所在路徑與索引

使用 WSH 建立捷徑的實作步驟

1. 加入 WSH 參考

在 Visual Studio 專案中，右鍵點選專案選擇「加入參考」，切換到 COM 分頁，勾選 Windows Script Host Object Model。這會引入 IWshRuntimeLibrary 命名空間，提供建立捷徑所需的介面。

2. 撰寫建立捷徑的程式碼

以下完整範例示範如何在桌面建立指向目前執行組件的捷徑：

using System;
using IWshRuntimeLibrary;

class Program
{
    static void Main(string[] args)
    {
        WshShell shell = new WshShell();
        string desktopPath = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory);
        string shortcutPath = System.IO.Path.Combine(desktopPath, "My Application.lnk");

        IWshShortcut shortcut = (IWshShortcut)shell.CreateShortcut(shortcutPath);
        shortcut.TargetPath = System.Reflection.Assembly.GetExecutingAssembly().Location;
        shortcut.WorkingDirectory = Environment.CurrentDirectory;
        shortcut.WindowStyle = 1; // 1 = 一般視窗
        shortcut.Description = "Launch My Application";
        // 使用系統 shell32.dll 中的第 165 個圖示
        shortcut.IconLocation = Path.Combine(Environment.SystemDirectory, "shell32.dll") + ", 165";
        shortcut.Save();
    }
}

關鍵屬性說明

• TargetPath：目標執行檔的完整路徑，這裡使用 Assembly.GetExecutingAssembly().Location 取得目前程式位置。
• WorkingDirectory：程式啟動時的工作目錄，通常設為 Environment.CurrentDirectory。
• WindowStyle：視窗顯示狀態，1 為正常，3 為最大化，7 為最小化。
• IconLocation：圖示來源，格式為「檔案路徑, 圖示索引」。
• Save()：務必呼叫此方法將捷徑寫入磁碟。

透過 WSH，我們能在 C# 中靈活建立、修改捷徑，滿足安裝程式、自動部署等實際開發需求。