FreeTube 护眼设置实战指南：主题与界面缩放手把手教程-开发者社区

FreeTube 护眼设置实战指南：主题与界面缩放手把手教程

【免费下载链接】FreeTubeAn Open Source YouTube app for privacy项目地址: https://gitcode.com/GitHub_Trending/fr/FreeTube

这篇 FreeTube 护眼设置教程帮你把界面调成不刺眼的状态：改好基础主题、配好主色、调好界面缩放。适合夜间看视频多、或者戴眼镜看屏幕容易累的人，全程只动设置面板里的几个开关和下拉框。

功能定位：护眼相关选项都藏在哪个模块

FreeTube 把界面颜色、缩放这些"看起来舒服不舒服"的选项集中在一个模块里：Theme Settings。它属于「Settings」页面下的一个独立配置区，管两件事——整套界面用哪套配色（Base Theme、主色、辅助色），以及界面元素的大小和交互细节。如果你只关心护眼、不想碰播放器参数，这个模块就是全部入口。

模块对应组件：ThemeSettings.vue

准备工作：打开入口并记下默认值

启动 FreeTube 桌面版。UI Scale 等缩放选项只在桌面版出现，网页版用不了，这点先确认。
点右上角齿轮图标 ⚙️ 打开「Settings」。
在左侧导航选「Theme」，页面右侧滚到Theme Settings区域。
先记下当前默认值，改错了方便回退：Base Theme默认 System Default，Main Color Theme默认 Red，Secondary Color Theme默认 Blue，UI Scale 默认100%。
主题相关改动保存即生效，无需重启；只有个别选项（后面会标出来）需要重启应用。

核心配置：按三个常见场景改

夜间看视频：深色主题怎么设

操作路径：Theme Settings →Base Theme下拉框。
关键参数：日常夜间选Dark，关灯环境选Black（纯黑背景，亮度最低）。注意别选Hot Pink，它的高饱和背景色夜间很刺眼。
判断生效：下拉框选完页面立刻换色，无需重启。切到 Black 后，背景应接近纯黑、文字保持浅色；如果界面没变化，看下面「问题排查」。

白天看视频：浅色主题怎么设

操作路径：同一个Base Theme下拉框。
关键参数：选Light；想要低饱和的柔和色，可以从Solarized Light、Gruvbox Light、Catppuccin Latte里挑，它们的配色噪声比默认白底小。
判断生效：页面立刻变浅底深字。白天用浅色的收益是文字对比度更高，比"一黑到底"更不容易看花眼。

字太小看不清：UI Scale 参数怎么设

操作路径：Theme Settings 区域里的UI Scale滑杆（仅桌面版显示）。
关键参数：范围50%–300%，步长 5%，默认 100%。建议从125%起步；小笔记本屏或近视人群可以直接给到150%。
判断生效：拖动滑杆界面即时放大，不用重启。放大后检查一遍侧边栏和顶栏有没有被挤出内容，有就回调 10% 再试。

进阶组合

Match Top Bar with Main Color：打开后顶栏颜色跟随主色。配合深色主题时，顶栏和正文区连成一片暗色，夜间切换页面更顺。
同时打开Hide Side Bar Labels和Hide FreeTube Header Logo，夜间界面只剩视频和必要文字，干扰最少。
主色别用饱和色：夜间把Main Color Theme和Secondary Color Theme都换成低饱和配色，订阅按钮、进度条这些常驻元素不会一直跳进眼睛。注意选Hot Pink基础主题时，两个配色下拉框会整体禁用，这是设计如此，不是坏了。
界面调完再去播放器设置里把Default Volume调到平时值，音量、播放速度、自动播放这些跟主题无关，不要顺手乱改。

问题排查

现象	可能原因	处理方式
改了 Base Theme 界面没变	应用内改动被拦截，或当前窗口没刷新	关闭设置面板再重新打开确认；仍无效则重启 FreeTube，重启后仍不生效就以实际版本为准
找不到 UI Scale 滑杆	用的是网页版，该选项仅桌面版（Electron）提供	安装或切换到桌面版再调
主色/辅助色下拉框是灰色	基础主题选了Hot Pink，此主题自带固定配色，会禁用配色选择	换一个基础主题，或保持现状
滚动页面有拖影、卡感	平滑滚动在高分辨率或低帧率窗口下明显	打开Disable Smooth Scrolling，应用会弹出重启确认，点"Yes, Restart"生效