# 文件

文件模块提供了功能强大的图形化文件管理器， 设计理念是尽可能还原 Windows 资源管理器的操作体验，支持右键菜单、拖拽上传、快捷键等特性。

## 文件管理器

![文件管理器](/images/file/file-list.png)

## 核心特性

### 类 Windows 操作体验

- **右键菜单**：右键点击文件或目录弹出操作菜单
- **拖拽上传**：直接将本地文件拖拽到浏览器窗口即可上传
- **多选操作**：支持 Ctrl+点击 多选，Shift+点击 范围选择
- **快捷键支持**：常用操作都有对应的快捷键

### 快捷键

| 快捷键      | 功能  |
| -------- | --- |
| `Ctrl+C` | 复制  |
| `Ctrl+X` | 剪切  |
| `Ctrl+V` | 粘贴  |
| `Delete` | 删除  |
| `F2`     | 重命名 |
| `Ctrl+A` | 全选  |

## 导航

### 路径导航

顶部显示当前路径的面包屑导航， 点击可以快速跳转到任意上级目录。

### 快捷按钮

- **后退**：返回上一个访问的目录
- **前进**：前进到下一个目录
- **上级目录**：返回上级目录
- **刷新**：刷新当前目录
- **主目录**：返回默认目录

## 文件列表

文件列表显示以下信息：

| 列     | 说明                 |
| ----- | ------------------ |
| 名称    | 文件或目录名称            |
| 大小    | 文件大小，目录显示「计算」可点击计算 |
| 权限    | 文件权限（如 0755）       |
| 所有者/组 | 文件的所有者和所属组         |
| 修改时间  | 最后修改时间             |
| 操作    | 打开、压缩、重命名、删除、更多    |

### 选择文件

![选择文件](/images/file/file-select.png)

选择文件后，顶部会显示批量操作按钮：

- **复制**：复制选中的文件
- **移动**：移动选中的文件
- **压缩**：压缩选中的文件
- **权限**：修改权限
- **删除**：删除选中的文件

### 更多操作

点击文件行的 **更多** 按钮，显示更多操作选项：

![更多操作](/images/file/file-context-menu.png)

- **复制**：复制文件到其他目录
- **移动**：移动文件到其他目录
- **权限**：修改文件权限和所有者
- **压缩**：压缩文件
- **复制路径**：复制文件的完整路径
- **属性**：查看文件详细属性

## 工具栏

### 新建

点击 **新建** 按钮可以：

- 新建文件
- 新建目录

### 上传

点击 **上传** 按钮上传本地文件到服务器。

支持的上传方式：

- 点击选择文件上传
- **拖拽上传**：直接将文件拖拽到页面即可上传

### 远程下载

点击 **远程下载** 按钮，输入 URL 地址，将远程文件下载到当前目录。

适用场景：

- 下载软件安装包
- 下载远程备份文件
- 从其他服务器获取文件

### 搜索

在搜索框输入关键词搜索文件：

- 默认搜索当前目录
- 勾选 **包括子目录** 可以递归搜索

### 终端

点击 **终端** 按钮可以在当前目录打开终端，方便执行命令行操作。

### 排序

点击 **排序** 按钮可以按不同字段排序文件列表。

## 文件编辑器

AcePanel 内置了功能强大的代码编辑器，基于 Monaco Editor（VS Code 同款编辑器内核）。

![文件编辑器](/images/file/file-editor.png)

### 编辑器特性

- **语法高亮**：支持各种编程语言的语法高亮
- **代码折叠**：支持代码块折叠
- **行号显示**：显示行号，方便定位
- **小地图**：右侧显示代码缩略图
- **自动换行**：可切换自动换行模式
- **多文件编辑**：支持同时打开多个文件，标签页切换

### 编辑器快捷键

| 快捷键            | 功能     |
| -------------- | ------ |
| `Ctrl+S`       | 保存当前文件 |
| `Ctrl+Shift+S` | 保存所有文件 |
| `Ctrl+F`       | 搜索     |
| `Ctrl+H`       | 替换     |
| `Ctrl+G`       | 转到指定行  |

### 编辑器工具栏

- **保存**：保存当前文件
- **保存所有**：保存所有修改的文件
- **刷新**：重新加载文件内容
- **搜索**：打开搜索面板
- **替换**：打开替换面板
- **转到**：跳转到指定行
- **字体大小**：调整编辑器字体大小
- **切换自动换行**：开启/关闭自动换行
- **切换小地图**：显示/隐藏右侧小地图
- **设置**：编辑器设置

### 全屏模式

点击 **最大化** 按钮可以全屏编辑，获得更大的编辑空间：

![全屏编辑器](/images/file/file-editor-fullscreen.png)

### 侧边栏文件树

编辑器左侧显示当前目录的文件树，可以：

- 快速切换编辑其他文件
- 新建文件
- 搜索文件

### 状态栏

编辑器底部状态栏显示：

- 文件完整路径
- 换行符类型（LF/CRLF）
- 光标位置（行、列）
- 缩进设置（空格/Tab）
- 文件语言类型

## 权限说明

Linux 文件权限由三组数字表示：

| 权限 | 数字 | 说明 |
| -- | -- | -- |
| r  | 4  | 读取 |
| w  | 2  | 写入 |
| x  | 1  | 执行 |

例如 `0755`：

- 所有者：7 (4+2+1) = 读+写+执行
- 所属组：5 (4+1) = 读+执行
- 其他用户：5 (4+1) = 读+执行

常用权限：

- `0644`：普通文件
- `0755`：可执行文件和目录
- `0600`：私密文件（如密钥）