工作区管理
VMark 中的工作区是将某个文件夹作为项目根目录打开。打开工作区后,侧边栏会显示文件树,快速打开功能会索引所有 Markdown 文件,终端从项目根目录启动,并且你打开的标签页会被记住以供下次使用。
没有工作区时仍然可以打开单个文件,但会失去文件浏览器、项目内搜索和会话恢复功能。
打开工作区
| 方式 | 操作 |
|---|---|
| 菜单 | 文件 > 打开工作区 |
| 快速打开 | Mod + O,然后在底部选择 **浏览... ** |
| 拖放 | 从 Finder 将 Markdown 文件拖入窗口——VMark 会自动检测其项目根目录并打开工作区 |
| 最近的工作区 | 文件 > 最近的工作区,选择之前的项目 |
打开工作区后,VMark 会在侧边栏显示文件浏览器。如果该工作区之前已打开过,之前打开的标签页会被恢复。
TIP
如果当前窗口有未保存的更改,VMark 会提示是否在新窗口中打开工作区,而不是替换当前内容。
文件浏览器
只要工作区已打开,文件浏览器就会显示在侧边栏中。它显示以工作区文件夹为根的 Markdown 文件树。
导航
- 单击 文件夹可展开或折叠
- 双击 或按 Enter 可在标签页中打开文件
- 非 Markdown 文件使用系统默认应用打开
文件操作
右键单击任意文件或文件夹可访问上下文菜单:
| 操作 | 描述 |
|---|---|
| 打开 | 在新标签页中打开文件 |
| 重命名 | 内联编辑文件或文件夹名称(也可按 F2) |
| 复制 | 创建文件的副本 |
| 移动到... | 通过对话框将文件移动到其他文件夹 |
| 删除 | 将文件或文件夹移至系统回收站 |
| 复制路径 | 将文件的绝对路径复制到剪贴板 |
| 在 Finder 中显示 | 在 Finder 中显示该文件(macOS) |
| 新建文件 | 在此位置创建新的 Markdown 文件 |
| 新建文件夹 | 在此位置创建新文件夹 |
你也可以直接在文件树中 拖放 文件到不同文件夹。
可见性切换
默认情况下,浏览器只显示 Markdown 文件并隐藏隐藏文件。两个切换开关可以改变此行为:
| 切换 | 快捷键 | 效果 |
|---|---|---|
| 显示隐藏文件 | Mod + Shift + .(macOS)/ Ctrl + H(Win/Linux) | 显示隐藏文件和隐藏文件夹 |
| 显示所有文件 | (设置或上下文菜单) | 在文档旁显示非 Markdown 文件 |
两个设置均按工作区保存,并在会话间持久保留。
排除的文件夹
以下文件夹默认从文件树中排除:
.gitnode_modules
这些默认设置在首次打开工作区时应用。
快速打开
按 Mod + O 打开快速打开覆盖层。它提供三个来源的模糊搜索:
- 你之前打开过的 最近文件
- 当前窗口中 已打开的标签页(以圆点标记)
- 工作区中的 所有 Markdown 文件
输入几个字符即可筛选——匹配是模糊的,所以 rme 可以找到 README.md。使用方向键导航,按 Enter 打开。底部有一行固定的 **浏览... ** 选项可打开文件对话框。
| 操作 | 快捷键 |
|---|---|
| 打开快速打开 | Mod + O |
| 导航结果 | ↑ / ↓ |
| 打开选中文件 | Enter |
| 关闭 | Escape |
TIP
没有工作区时,快速打开仍然有效——它会显示最近文件和已打开的标签页,但无法搜索文件树。
最近的工作区
VMark 最多记住 10 个最近打开的工作区。从菜单栏的 文件 > 最近的工作区 访问它们。
- 工作区按最后打开时间排序(最新的在最前面)
- 列表在每次更改时同步到原生菜单
- 选择 清除最近的工作区 可重置列表
工作区设置
每个工作区都有自己的配置,在会话间持久保留。设置存储在 VMark 应用数据目录中——而不是项目文件夹内——以保持项目文件夹的整洁。
以下设置按工作区保存:
| 设置 | 描述 |
|---|---|
| 排除的文件夹 | 从文件浏览器中隐藏的文件夹 |
| 显示隐藏文件 | 隐藏文件是否可见 |
| 显示所有文件 | 非 Markdown 文件是否可见 |
| 上次打开的标签页 | 用于下次打开时恢复会话的文件路径 |
TIP
工作区配置与文件夹路径绑定。在同一台机器上打开相同文件夹时,总是会恢复你的设置,即使从不同窗口打开也是如此。
会话恢复
当你关闭一个已打开工作区的窗口时,VMark 会将已打开标签页的列表保存到工作区配置中。下次打开同一工作区时,这些标签页会自动恢复。
- 只有带有已保存文件路径的标签页才会恢复(未命名标签页不会持久保存)
- 如果某个文件自上次会话以来已被移动或删除,则会静默跳过
- 会话数据在窗口关闭和工作区关闭(文件 > 关闭工作区)时保存
多窗口
每个 VMark 窗口可以有独立的工作区,让你可以同时处理多个项目。
- 文件 > 新建窗口 打开一个新窗口
- 在新窗口中打开工作区不会影响其他窗口
- 窗口大小和位置按窗口记住
当你从 Finder 拖入 Markdown 文件而当前窗口已有未保存的工作时,VMark 会自动在新窗口中打开该文件的项目。
终端集成
集成终端自动以工作区根目录作为其工作目录。当你打开或切换工作区时,所有终端会话都会 cd 到新的根目录。
在每个终端会话中,VMARK_WORKSPACE 环境变量会被设置为工作区路径,以便你的脚本可以引用项目根目录。