1. 问题背景
在 Linux (如 Ubuntu) 环境下使用 Xilinx Vitis 进行开发时,启动界面的 "Select a directory as workspace" 下拉列表中常常会堆积大量无效、重复或已过期的路径。
即使在界面中切换了新的工作空间,这些旧的历史记录依然会顽固地停留在列表中,无法通过 GUI 直接删除。由于 Vitis 是基于 Eclipse 构建的,我们可以通过修改底层的配置文件来手动"彻底"清理这些历史记录。
2. 核心原理与注意事项
Vitis 的历史工作空间记录存储在用户 Home 目录下的配置文件中。
⚠️ 关键注意(版本坑点):
即使你使用的是较新版本的 Vitis(例如 2022.2 ),它的配置文件目录很可能沿用旧版本 (例如 2020.2)的文件夹。
实测发现: 在 Vitis 2022.2 环境下,配置文件的实际存储位置位于
2020.2目录中。因此,如果在新版本号目录下找不到配置文件,请务必检查旧版本的目录。
3. 操作步骤
第一步:定位配置目录
首先,打开终端。建议先进入 Vitis 的根配置目录查看实际存在的版本文件夹。
bash
# 进入 Xilinx Vitis 配置根目录
cd ~/.Xilinx/Vitis/
# 查看当前目录下有哪些版本的文件夹
ls
假设你看到了 2020.2 和 2022.2,但根据经验,我们需要进入旧版本(或实际存储配置的版本)的设置目录:
bash
# 进入包含配置文件的目录(以 2020.2 为例)
cd 2020.2/.settings/
第二步:编辑配置文件
在该目录下,找到名为 org.eclipse.ui.ide.prefs 的文件,这是 Eclipse UI 的首选项配置文件。
使用你喜欢的文本编辑器(如 nano 或 vim)打开它:
bash
# 使用 nano 打开
nano org.eclipse.ui.ide.prefs
# 或者使用 vim 打开
vim org.eclipse.ui.ide.prefs
第三步:清除历史记录
在打开的文件中,寻找以 RECENT_WORKSPACES 开头的那一行。这一行记录了所有显示在启动界面的历史路径,通常以 \n 作为分隔符。
文件内容示例:
properties
MAX_RECENT_WORKSPACES=10
RECENT_WORKSPACES=/home/user/workspace_old\n/home/user/workspace_project_A
SHOW_RECENT_WORKSPACES=false
执行操作:
直接删除 整行 RECENT_WORKSPACES=...。
保存并退出:
- Nano 用户: 按
Ctrl + O保存 →\rightarrow→Enter确认 →\rightarrow→Ctrl + X退出。 - Vim 用户: 按
dd删除当前行 →\rightarrow→ 输入:wq保存并退出。
4. 结果验证
重新启动 Vitis。此时你会发现启动界面的 Recent Workspaces 下拉列表已被清空,只保留默认路径或变为空白,界面恢复整洁。