跳至主要内容

SymlinkUtility

重要 注意 提醒

Coding Style wiki


SymlinkUtility 提供在專案中建立資料夾符號連結的選單工具,可將專案外部的共用資料夾Junction / 絕對 Symlink / 相對 Symlink 連結進專案使用 (例如共用美術資源、跨專案共用模組),並於 Project 視窗對符號連結資料夾顯示 <=> 標記 (修改自 karl-/unity-symlink-utility)。

命名空間OxGKit.Utilities.Symlink.Editor
類型public static class SymlinkUtility
原始碼SymlinkUtility.cs

Project 視窗 Right-Click (或 Assets 選單) 操作,會開啟資料夾選擇視窗選取來源資料夾,並於當前選取的資料夾 (未選取時為 Assets) 之下建立連結:

選單說明
Assets/Create/Folder (Junction)建立 Junction 連結 (僅 Windows,不需系統管理員權限)。
Assets/Create/Folder (Absolute Symlink)建立絕對路徑符號連結。
Assets/Create/Folder (Relative Symlink)建立相對路徑符號連結。

注意 Windows 上建立 Symlink (Absolute / Relative) 需要系統管理員權限 (會跳出 UAC 提示),Junction 則不需要;macOS 透過 ln -s 建立。

通用規則

限制條件

  • 來源資料夾不可位於本專案內 (Application.dataPath 之下),否則會輸出警告並中止。
  • 目標位置已存在同名資料夾時會中止連結。
  • 建立完成後會自動 AssetDatabase.Refresh
  • Project 視窗中,符號連結 (含 Junction) 的資料夾右側會顯示 <=> 標記,方便辨識。

提醒 符號連結資料夾內的資源會被 Unity 視為專案內資源匯入;團隊協作時,請確保成員本機皆有對應的來源資料夾,並留意版本控制 (VCS) 對符號連結的處理方式。