新装 Ubuntu 26.04 GNOME 桌面后,系统默认生成「桌面、下载、文档、音乐、图片、视频」中文家目录,命令行操作路径带中文极易出现编码、脚本读取异常;不少人手动删除文件夹后,文件管理器侧边栏出现黄色三角警告,提示找不到目录。这个是根据你安装系统时选择的语言,如果是英文的话就显示(Desktop,Download等目录。)
一、前置原理:Ubuntu 用户目录映射机制
GNOME 桌面所有侧边栏目录绑定配置文件:~/.config/user-dirs.dirs
文件内定义 Desktop/Downloads 等文件夹对应路径,分两种故障场景:
- 目录名中文:配置指向
~/下载等中文路径; - 文件夹误删:配置存在,但物理目录丢失,文件管理器弹出路径找不到警告。 工具核心两个:
xdg-user-dirs-gtk-update:图形弹窗一键切换中英文目录映射;xdg-user-dirs-update --force:纯终端强制刷新目录、自动重建文件夹。
方案 1:图形弹窗一键把中文目录改成英文(可视化操作)
1、报错前置修复(Locale 不支持弹窗弹不出解决)
执行xdg-user-dirs-gtk-update提示Locale not supported by C library、无窗口时,先执行:
# 生成英文语言包
sudo locale-gen en_US.UTF-8
sudo update-locale
# 临时加载英文环境变量
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
# 启动图形切换弹窗
xdg-user-dirs-gtk-update
2、弹窗操作步骤
弹出窗口Update standard folders to current language?
- 表格会列出所有中文目录对应英文路径:
/home/xxx/下载 → /home/xxx/Downloads; - 勾选
Don’t ask me this again; - 点击红框按钮 Update Names,更新配置映射;
注意:该操作仅修改配置,不会自动迁移中文文件夹内文件,需手动复制文件到新英文目录。
方案 2:纯终端无弹窗方案(弹窗失效 / 不想装图形工具首选)
适用于xdg-user-dirs-gtk-update打不开、TTY 终端环境、图形组件异常场景,一步到位修改映射 + 重建文件夹。
1、查看文件内容(默认应该是存在的),我们直接删除该文件
cat ~/.config/user-dirs.dirs
#内容大概如下的
XDG_DESKTOP_DIR="$HOME/Desktop"
XDG_DOWNLOAD_DIR="$HOME/Downloads"
XDG_TEMPLATES_DIR="$HOME/Templates"
XDG_PUBLICSHARE_DIR="$HOME/Public"
XDG_DOCUMENTS_DIR="$HOME/Documents"
XDG_MUSIC_DIR="$HOME/Music"
XDG_PICTURES_DIR="$HOME/Pictures"
XDG_VIDEOS_DIR="$HOME/Videos"
2、 强制刷新用户目录配置
# 注意参数拼写:--force
xdg-user-dirs-update --force
#它带上参数后就不需要手动创建目录了,它会根据上面配置文件中的目录,强制生成出来。
3、重启文件管理器清除缓存,消除侧边栏黄色警告
nautilus -q
4、迁移旧中文文件夹文件(可选)
确认英文目录可用后,将中文目录文件迁移,示例(文档文件夹):
因为这个不会自动迁移数据的,所以要自己手动复制相应目录下的数据。
mv ~/文档/* ~/Documents/
全部迁移完成后,删除空中文文件夹:
rm -rf ~/桌面 ~/下载 ~/文档 ~/音乐 ~/图片 ~/视频 ~/模板 ~/公共
场景:误删目录后一键恢复(侧边栏三角警告修复)
如果手动删除 Desktop/Downloads 等文件夹,打开文件管理器提示Unable to find "/home/xxx/Documents",直接执行两行命令修复:
# 重建缺失目录 + 刷新配置
xdg-user-dirs-update --force
# 重启文件管理器生效
nautilus -q
执行后侧边栏黄色警告自动消失,缺失文件夹全部重建。
故障排错(Ubuntu26.04 专属踩坑合集)
故障 1:执行 xdg-user-dirs-gtk-update 无任何弹窗
- 安装图形工具依赖包
sudo apt install xdg-user-dirs-gtk
- 按本文 2.1 小节修复 Locale 英文语言包缺失问题,再重新执行命令。就是要系统检测到切换语言了才会触发,不然执行上面的方案2命令解决。
故障 2:切换系统语言后目录自动变回中文
注销重登弹出更新窗口时,务必选择 Keep Old Names,并勾选不再提示,即可永久锁定英文目录映射。
最后希望,如果你遇到了类似问题请认真阅读到最后,再考虑使用哪个方案解决问题。