代码编辑器文件操作与项目管理完全指南

/* 文件文档模型 */
class TextDocument {
    constructor(filePath, content = '') {
        this.filePath = filePath;           // 文件路径
        this.content = content;             // 文档内容
        this.encoding = 'utf-8';         // 文件编码
        this.isDirty = false;             // 是否已修改
        this.lastModified = null;        // 最后修改时间
        this.version = 0;                  // 版本号（用于冲突检测）
    }

    /* 设置内容并标记为已修改 */
    setContent(newContent) {
        if (newContent !== this.content) {
            this.content = newContent;
            this.isDirty = true;
            this.version++;
        }
    }
}

/* 文件读写管理器 */
class FileManager {
    constructor(editor) {
        this.editor = editor;
        this.pendingOperations = new Map();
    }

    /* 读取文件内容 */
    async readFile(filePath) {
        try {
            const response = await fetch(filePath);
            if (!response.ok) {
                throw new Error(`Failed to read file: ${response.status}`);
            }
            return await response.text();
        } catch (error) {
            console.error('Read file error:', error);
            throw error;
        }
    }

    /* 保存文件 */
    async writeFile(filePath, content) {
        // 触发保存前钩子
        await this.editor.trigger('beforeSave', { filePath, content });

        // 实际保存逻辑（通过后端API）
        const result = await saveToBackend(filePath, content);

        // 触发保存后钩子
        await this.editor.trigger('afterSave', { filePath });
    }
}

/* 文件监听管理器 */
class FileWatcher {
    constructor(editor) {
        this.editor = editor;
        this.watchers = new Map();
        this.fs = require('fs');
    }

    /* 监听文件变化 */
    watch(filePath) {
        if (this.watchers.has(filePath)) return;

        const watcher = this.fs.watch(filePath, (eventType) => {
            if (eventType === 'change') {
                this.handleFileChange(filePath);
            }
        });

        this.watchers.set(filePath, watcher);
    }

    /* 处理文件变化事件 */
    handleFileChange(filePath) {
        const doc = this.editor.getDocument(filePath);
        if (!doc || !doc.isDirty) {
            // 文件未修改，提示用户重新加载
            this.promptReload(filePath);
        }
    }

    /* 提示用户重新加载 */
    promptReload(filePath) {
        // 显示通知让用户选择
        this.editor.showNotification({
            message: `文件 ${filePath} 已被外部修改`,
            actions: [
                { label: '重新加载', action: 'reload' },
                { label: '忽略', action: 'ignore' }
            ]
        });
    }
}

/* 自动保存管理器 */
class AutoSaveManager {
    constructor(editor) {
        this.editor = editor;
        this.timer = null;
        this.delay = 3000;  // 3秒延迟
    }

    /* 启动自动保存 */
    start() {
        this.scheduleSave();
    }

    /* 调度保存操作 */
    scheduleSave() {
        if (this.timer) {
            clearTimeout(this.timer);
        }

        this.timer = setTimeout(async () => {
            await this.performAutoSave();
            this.scheduleSave();
        }, this.delay);
    }

    /* 执行自动保存 */
    async performAutoSave() {
        const docs = this.editor.getDirtyDocuments();

        for (const doc of docs) {
            // 只保存非临时文件
            if (!isTemporaryFile(doc.filePath)) {
                await this.editor.fileManager.writeFile(doc.filePath, doc.content);
                doc.isDirty = false;
            }
        }
    }
}

/* 项目管理器 */
class ProjectManager {
    constructor(editor) {
        this.editor = editor;
        this.currentProject = null;
    }

    /* 打开项目 */
    async openProject(projectPath) {
        // 读取项目配置文件
        const config = await loadProjectConfig(projectPath);

        // 构建项目文件树
        const fileTree = await buildFileTree(projectPath);

        // 初始化项目
        this.currentProject = {
            path: projectPath,
            config,
            fileTree
        };

        // 更新编辑器状态
        this.editor.setState({ project: this.currentProject });
    }

    /* 获取项目根目录 */
    getRootPath() {
        return this.currentProject?.path;
    }
}