【开发工具】自动创建项目文件夹结构

_Athie2026-06-14 8:15

自动创建项目文件夹

每次创建新工程或者新的功能模块时，都要把工程结构目录重新创建一遍。

反复执行右键->Create->Folder->重命名文件夹的行为。(好像很忙又好像啥也没忙)

于是，一个自动创建项目文件夹的工具就很有必要了。

核心需求

  • 想把旧项目的目录结构移植到新工程。

    复制路径UI\HUD\Settings，根据这个字符串自动创建文件夹。

  • 用命名空间创建文件夹。

  • 在Assets下自定义创建文件夹。

配置示例

markdown 复制代码 
# 默认以 Assets/Scripts 为根目录
# 空行和以#开头的行会被忽略
# ../ 开头的行会以 Assets 为根目录


# 1.根据路径创建脚本文件夹
# 文件夹示例：Assets/Scripts/UI/HUD/Settings
UI\HUD\Settings

# 2.根据命名空间创建脚本文件夹
# 文件夹示例：Assets/Scripts/Game/Data/Speed
Game.Data
Game.Data.Speed
Utilities.Debug

# 3.创建常见的资源文件夹
# 文件夹示例：Assets/Resources
../Resources
../Resources/Font
../Resources/Material
../Resources/Mesh
../Resources/Shaders
../Plugins
../Scenes
../StreamingAssets

1. 创建工具窗口

在Assets/Editor下创建脚本AutoCreateGameFolders.cs

c# 复制代码 
using System.Collections.Generic;
using System.IO;
using System.Text;
using UnityEditor;
using UnityEngine;

namespace Assets.Editor
{
    public class AutoCreateGameFolders : EditorWindow
    {        
        string basePath = "Assets/Scripts";
        private string configFileName = "Editor/folder_structure.txt";
        private string configFilePath = "";

        [MenuItem("Tools/Auto Create Folders")]
        public static void ShowWindow()
        {
            AutoCreateGameFolders window = GetWindow<AutoCreateGameFolders>("Create Game Folders");
            window.minSize = new Vector2(400, 300);
            window.LoadConfigPath();
            window.Show();
        }

        private void LoadConfigPath()
        {
            configFilePath = Path.Combine(Application.dataPath, configFileName);
        }

        private void OnGUI()
        {
            GUILayout.Label("动态读取配置文件创建文件夹", EditorStyles.boldLabel);
            GUILayout.Space(10);

            EditorGUILayout.HelpBox(@$"读取文件夹结构配置:
{configFilePath}

以 {basePath} 为根目录创建所有文件夹",
                MessageType.Info
            );
            GUILayout.Space(10);

            if (CheckConfigExists())
            {
                GUI.backgroundColor = Color.green;
                if (GUILayout.Button("Create Folder Structure", GUILayout.Height(40)))
                {
                    CreateFoldersFromConfig();
                }
                GUILayout.Space(10);
            }
        }
        
        // 2.创建配置文件
        private bool CheckConfigExists() {}
        
        // 3.创建目录结构
        private void CreateFoldersFromConfig() {}
    }    
}

2. 创建配置文件

2.1. 检查配置文件是否存在

c# 复制代码 
/// <summary> 检查配置文件是否存在  </summary>
private bool CheckConfigExists()
{
    // 检查配置文件是否存在
    bool configExists = File.Exists(configFilePath);
    if (!configExists)
    {
        EditorGUILayout.HelpBox(
            $"配置文件不存在！\n请在 {configFilePath} 创建配置文件。",
            MessageType.Error
        );

        if (GUILayout.Button("创建示例配置文件"))
        {
            CreateExampleConfig();
        }
    }
    return configExists;
}

2.2. 创建示例配置文件

c# 复制代码 
private void CreateExampleConfig()
{    
    string exampleContent = @"# 默认以 Assets/Scripts 为根目录
# 空行和以#开头的行会被忽略
# ../ 开头的行会以 Assets 为根目录


# 1.根据路径创建脚本文件夹
# 文件夹示例：Assets/Scripts/UI/HUD/Settings
UI\HUD\Settings

# 2.根据命名空间创建脚本文件夹
# 文件夹示例：Assets/Scripts/Game/Data/Speed
Game.Data
Game.Data.Speed
Utilities.Debug

# 3.创建常见的资源文件夹
# 文件夹示例：Assets/Resources
../Resources
../Resources/Font
../Resources/Material
../Resources/Mesh
../Resources/Shaders
../Plugins
../Scenes
../StreamingAssets
";
    File.WriteAllText(configFilePath, exampleContent);
    AssetDatabase.Refresh();

    string log = $"示例配置文件已创建在:\n{configFilePath}";
    Debug.Log(log);
    EditorUtility.DisplayDialog("成功", $"{log}\n\n请根据需要修改后再次运行。", "确定");
}

3. 创建目录结构

3.1. 检查配置的内容是否有效

c# 复制代码 
private bool TryReadConfigFile(out List<string> folders)
{
    if (!File.Exists(configFilePath))
        return false;
    
    folders = new List<string>();

    string[] lines = File.ReadAllLines(configFilePath);
    foreach (string line in lines)
    {
        string trimmedLine = line.Trim();

        // 跳过空行和注释行
        if (string.IsNullOrEmpty(trimmedLine) || trimmedLine.StartsWith("#"))
        {
            continue;
        }

        // 确保路径使用正斜杠
        trimmedLine = trimmedLine.Replace("\\", "/");
        folders.Add(trimmedLine);
    }

    return folders.Count > 0;
}

3.2. 创建多个文件夹

配置的内容无效时，导入示例配置

c# 复制代码 
private void CreateFoldersFromConfig()
{
    if (!TryReadConfigFile(out List<string> folders))
    {
        bool reloaad = EditorUtility.DisplayDialog("错误", 
            "配置文件中没有有效的文件夹路径！", 
            "导入示例配置", "取消");
        if (reloaad)
        {
            CreateExampleConfig();
        }
        return;
    }

    // 创建基础目录
    if (!Directory.Exists(basePath))
    {
        Directory.CreateDirectory(basePath);
        Debug.Log($"创建基础目录: {basePath}");
    }

    // 创建每个子文件夹
    CreateFolders(folders);

    AssetDatabase.Refresh();
}
  • 创建每个的子文件夹
c# 复制代码 
private void CreateFolders(List<string> folders)
{    
    int createdCount = 0;
    int existCount = 0;

    StringBuilder logSkipped = new StringBuilder("文件夹已存在，跳过:\n");
    StringBuilder logCreated = new StringBuilder("创建文件夹:\n");
    // 创建每个子文件夹
    foreach (string folder in folders)
    {
        string fullPath;
        if (folder.StartsWith("../")) // 以 Assets 为根目录
        {
            fullPath = Path.Combine("Assets", folder.Replace("../", "").Replace(".", "/"));
        }
        else // 根据路径、命名空间创建
        {
            fullPath = Path.Combine(basePath, folder.Replace(".", "/"));
        }

        if (!Directory.Exists(fullPath))
        {
            Directory.CreateDirectory(fullPath);
            logCreated.AppendLine($"{fullPath}");
            createdCount++;
        }
        else
        {
            logSkipped.AppendLine($"{fullPath}");
            existCount++;
        }
    }
    if (createdCount > 0) Debug.Log(logCreated);
    if (existCount > 0) Debug.Log(logSkipped);

    // 显示结果
    string message = $"文件夹结构创建完成！\n\n新创建: {createdCount} 个\n已存在: {existCount} 个\n总计: {folders.Count} 个";
    Debug.Log(message);
    EditorUtility.DisplayDialog("完成", message, "确定");
}

扩展功能

预览配置中的有效内容

c# 复制代码 
public class AutoCreateGameFolders : EditorWindow
{
    private Vector2 scrollPosition;

    // ......

    private void PreviewFolderStructure()
    {
        EditorGUILayout.LabelField("预览配置文件夹", EditorStyles.boldLabel);
        bool result = TryReadConfigFile(out List<string> foldersToCreate);
        if (!result) return;

        scrollPosition = EditorGUILayout.BeginScrollView(scrollPosition, GUILayout.Height(200));

        foreach (string folder in foldersToCreate)
        {
        	EditorGUILayout.LabelField(folder, EditorStyles.boldLabel);
        }

        EditorGUILayout.EndScrollView();
    }
}

在窗口中显示预览

c# 复制代码 
private void OnGUI()
{
	// ......
	
    if (CheckConfigExists())
    {
        PreviewFolderStructure();
        GUILayout.Space(10);
        // ......
    }
}

演示视频

根据txt内容，自动创建项目文件夹。 可根据路径、命名空间、自定义路径自动创建。 支持正反斜杠、行注释。

自动创建项目文件夹结构

交互优化

配置创建在项目根目录下

为了减少不必要*.txt.meta生成，期望把配置文件创建在项目根目录下。

修改LoadConfigPath()和configFileName

c# 复制代码 
public class AutoCreateGameFolders : EditorWindow
{        
    private string configFileName = "folder_structure.txt";
    
    private void LoadConfigPath()
    {
        string projectRootPath = Application.dataPath.Remove(Application.dataPath.Length - 6);
        configFilePath = Path.Combine(projectRootPath, configFileName);
    }
}

从编辑器中浏览配置文件

为了快速修改配置文件，在工具窗口和创建配置时，允许直接打开文件编辑。

  • 在窗口中增加跳转
c# 复制代码 
private void OnGUI()
{
    // ......

    if (CheckConfigExists())
	{
	    if (GUILayout.Button($"Browse {configFileName}", GUILayout.Height(20)))
	    {
	        BrowseConfigFile(configFilePath);
	    }
	    // ......
    }
}

private void BrowseConfigFile()
{
    System.Diagnostics.Process.Start($"{configFilePath}");
}
  • 创建示例配置文件后，允许直接打开
c# 复制代码 
private void CreateExampleConfig()
{ 
    // ......
   
    string log = $"示例配置文件已创建在:\n{configFilePath}";
    Debug.Log(log);
    bool browse = EditorUtility.DisplayDialog("成功", 
        $"{log}\n\n请根据需要修改后再次运行。",
        "打开配置", "取消");
    if (browse) BrowseConfigFile();
}
相关推荐
VidDown17 天前
VidDown 工具站：免费、本地优先的开发者工具箱
javascript·编辑器·音视频·视频编解码·视频
VidDown17 天前
显卡处理视频技术详解：从硬解码到 NVENC，GPU 如何让视频处理起飞？
javascript·编辑器·音视频·视频编解码·视频
夜猫逐梦17 天前
【UE基础】03.蓝图与编辑器工作流
编辑器·ue·蓝图·ue编辑器
VidDown17 天前
视频帧率技术详解：从 24fps 到 120fps，帧率如何影响你的观看体验？
网络·网络协议·编辑器·音视频·视频编解码·视频
叶帆17 天前
【YFIOs】用C#开发硬件之设备上云
开发语言·unity·c#
爱就是恒久忍耐17 天前
VSCode里如何比较2个branch
ide·vscode·编辑器
久数君17 天前
AI三维建模工具“造形家”：地理场景三维化的高效解决方案
unity·glb·ai算法·ai三维建模工具·地图框选·造形家·城市建筑模型
bloglin9999917 天前
vscode中可视化的合并分支，在“合并编辑器中解析”中“与基线进行比较”是什么意思
ide·vscode·编辑器
会思考的猴子18 天前
Unity VFX 属性 Postion 和 TargetPostion
unity
zyplayer-doc18 天前
企业知识库安全与权限管理完全指南：从加密到审计的六层防护
人工智能·安全·pdf·编辑器·创业创新
热门推荐
012026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf02GitHub 镜像站点03【AI】2026 年具身智能模型和世界模型总结04AI科技热点日报 | 2026年07月01日052026 AI 编程工具终极实战指南：Cursor vs Claude Code vs Copilot，开发者该怎么选？062026年6月AI大模型全景报告：GPT-5.6、Claude Opus 4.8、Gemini 3.5，中美AI三足鼎立谁主沉浮？072026 年 AI 大模型 & AI 编程工具实战全总结08Claude Code、Codex、Cursor三分天下：2026年AI编程Agent生态全景剖析092026年6月AI行业全景：从百模大战到Agent元年，这30天发生了什么？10Trae国际版与国内版深度测评：AI原生IDE的双生花