1.

从“屏幕倒立”说起：为什么你的树莓派屏幕方向不对？

刚拿到树莓派4B，兴冲冲地装好系统，接上屏幕，结果发现整个世界都颠倒了——屏幕显示是倒过来的，或者横着竖着，鼠标点东它往西。

这事儿我遇到过不止一次，尤其是帮朋友调试各种奇奇怪怪的屏幕时。

一开始我也很懵，以为硬件坏了，后来才发现，这其实是树莓派世界里一个非常经典又有点“恼人”的小问题。

简单来说，屏幕方向不对，根源在于屏幕的物理安装方向与系统默认的显示坐标系不匹配。

比如，你把一个原本设计为横屏的官方屏幕竖着装在机箱里，或者你用的是一块从旧设备上拆下来的非官方屏幕，它的驱动信息可能没有被系统正确识别。

树莓派系统默认假设屏幕是“正常”方向（0度旋转），一旦物理方向变了，显示和触控自然就乱套了。

这跟你用手机时开启屏幕旋转是一个道理，只不过在树莓派上，我们需要手动告诉系统：“嘿，我的屏幕现在是这么装的。

”

别担心，这个问题百分之百可以通过软件配置解决，完全不需要动烙铁。

解决思路也清晰分为两条主线：显示旋转和触控旋转。

前者管你看到什么，后者管你的手指或鼠标点在哪里。

两者必须同步调整，否则就会出现“画面正了，但点不准”的尴尬情况。

接下来，我就带你从最官方的“一条命令搞定”方案，到应对各种“野生”屏幕的进阶玩法，把屏幕旋转这点事儿彻底讲透。

2.

官方屏幕的“特权”：最省心的旋转方案

如果你用的是树莓派基金会推出的官方触摸屏（比如那个7英寸的DSI接口屏幕），那么恭喜你，你享受的是“亲儿子”待遇。

官方屏幕的驱动和系统内核深度集成，调整旋转角度简单到令人发指，这也是我最初那台树莓派快速解决问题的原因。

2.1

核心配置文件：/boot/config.txt

树莓派的很多底层硬件配置，都集中在一个叫/boot/config.txt的文件里。

这个文件在启动时最早被加载，直接影响内核和固件对硬件的初始化。

对于官方屏幕，旋转屏幕只需要在这个文件里添加一行参数。

操作步骤非常直接：

1. 首先，用读卡器将你的树莓派系统SD卡连接到电脑上，或者直接在树莓派系统里打开终端。

2. 找到并编辑/boot/config.txt文件。

   你需要使用sudo权限。

   sudo
   nano
   /boot/config.txt

3. 滚动到文件末尾，添加下面这行魔法指令：

   lcd_rotate=2

4. 按Ctrl+X，然后按Y确认保存，再按回车退出编辑器。

5. 重启你的树莓派。

   这是关键一步，因为配置只在启动时生效。

这里的lcd_rotate就是控制官方屏幕旋转的核心参数。

它的值可以是0、1、2、3，分别对应0度、90度、180度和270度顺时针旋转。

我一般会先物理上把屏幕固定成我想要的方向，然后根据画面是倒着的还是侧着的，来尝试不同的值。

比如画面是上下颠倒，那就是180度旋转，设置lcd_rotate=2。

2.2

一个命令的“陷阱”与优势

看起来一条命令就解决了，是不是太简单了？这里有个非常重要的细节：当你设置了lcd_rotate，不仅仅是显示画面旋转了，系统也会自动尝试旋转触控坐标，让触控和显示保持同步。

这是官方方案最大的优势——一站式解决。

但是，这也引出了一个“陷阱”。

这个自动同步是基于官方屏幕的驱动实现的。

如果你用的不是官方屏幕，或者在某些非常规系统下，这个参数可能无效，或者只旋转了显示而没旋转触控。

所以，如果你按照这个方法操作了，重启后发现屏幕画面正常了，但触控还是错乱的，那很可能你的屏幕并非真正的“官方屏幕”，或者驱动层面有些特殊。

这时，我们就需要进入更通用的解决方案了。

3.

非官方屏幕的通用解法：xrandr的威力

市面上绝大多数的HDMI接口屏幕、以及很多第三方的DSI屏幕，都属于“非官方”范畴。

它们没有lcd_rotate这种“特权指令”，但我们可以通过一个强大的工具——xrandr（X

Resize

Rotate）来在系统启动后动态调整显示设置。

xrandr是Linux桌面环境（包括树莓派的Raspbian/Pi

OS）中管理显示输出的标准工具，功能非常强大。

3.1

使用xrandr命令行即时旋转

首先，我们可以在图形界面启动后，直接通过终端命令来测试旋转效果。

打开一个终端，输入以下命令：

#
xrandr
normal

输入命令的瞬间，你就能看到屏幕显示方向发生变化。

这个方法的好处是即时生效，可以让你快速测试哪个旋转方向是你需要的。

但缺点是：这只对当前会话有效，一旦重启，设置就会丢失。

而且，它通常只旋转显示，不旋转触控。

3.2

创建开机自启动脚本

为了让旋转效果永久生效，我们需要让系统在每次启动到桌面时自动执行xrandr命令。

有几种方法可以实现，这里介绍最通用的一种：创建

systemd

用户服务。

1. 创建服务文件：

   sudo
   nano
   /etc/systemd/system/rotate-screen.service

2. 写入以下内容（以旋转90度为例）：

   [Unit]
   Screen
   Environment="DISPLAY=:0"
   Environment="XAUTHORITY=/home/pi/.Xauthority"
   left
   WantedBy=multi-user.target

   注意：请将/home/pi和User=pi替换成你实际使用的用户名。

3. 启用并启动服务：

   sudo
   systemctl
   rotate-screen.service

4. 重启树莓派，检查屏幕是否自动旋转。

这个方法比在~/.config/autostart里放脚本更可靠，因为它不依赖于特定的桌面环境，只要系统进入多用户运行级别（图形界面）就会执行。

现在，你的非官方屏幕显示方向问题应该解决了。

但战斗只进行了一半，接下来要啃硬骨头——让触控也跟着转过来。

4.

触控旋转的精细调整：搞定“指东打西”

解决了显示旋转，接下来就是触控校准。

否则你会发现，画面是正了，但你想点屏幕右下角的按钮，却需要去戳左上角才行，非常抓狂。

触控旋转的核心，是修改触控设备的坐标变换矩阵。

4.1

确认你的触控设备与驱动

首先，我们需要知道系统把你的触摸屏识别成了什么设备，以及它使用什么驱动。

在终端中输入：

DISPLAY=:0
xinput
--list

你会看到一个设备列表。

仔细找找，其中应该有一个名字里包含“touchscreen”、“touch”、“触控”或者类似你屏幕型号的设备。

记下它的id和名称。

例如，输出可能包含：

⎡
Virtual
(2)]

这里raspberrypi-ts的id就是

11。

接下来，查看这个设备的详细属性，特别是驱动：

xinput
--list-props
11

（请将11替换为你设备的实际ID）

在输出信息中，寻找类似libinput的关键字。

如果驱动是libinput（现代树莓派OS的默认选择），那么恭喜，后续步骤会相对顺利。

如果显示的是evdev或其他驱动，方法会有所不同，但libinput是目前最主流和推荐的方式。

4.2

为libinput驱动配置坐标变换

libinput驱动允许我们通过一个叫做TransformationMatrix的选项来定义一套3x3的变换矩阵，从而旋转、缩放或平移触控坐标。

这个矩阵需要与你的屏幕旋转方向精确匹配。

我们需要编辑libinput的配置文件。

文件通常位于以下两个目录之一：

• /usr/share/X11/xorg.conf.d/
• /etc/X11/xorg.conf.d/

找到名为40-libinput.conf的文件。

如果没有，可能需要先安装：

sudo
apt
xserver-xorg-input-libinput

使用sudo权限编辑这个文件：

sudo
nano
/usr/share/X11/xorg.conf.d/40-libinput.conf

在文件中，找到针对触摸屏的InputClass段落。

它通常包含Identifier为

“libinput

或类似字样。

在这个段落的EndSection之前，添加Option

"TransformationMatrix"行。

关键：根据你的屏幕旋转方向，添加对应的矩阵。

假设你的屏幕使用xrandr

left旋转了显示，那么触控也需要匹配这个“left”旋转。

这里给出常用的四个矩阵：

例如，你的屏幕需要向左旋转90度（left），就在触摸屏配置段落里添加：

Option
"0
1"

修改后的配置段落看起来像这样：

Section
"InputClass"
EndSection

保存文件，然后重启系统。

重启后，显示和触控应该就同步旋转了。

4.3

验证与微调：校准触控精度

配置完成后，强烈建议进行触控校准测试。

你可以打开一个绘图软件，或者用鼠标设置里的“校准触摸屏”选项（如果有的话），沿着屏幕边缘画线，看看光标是否精准跟随。

如果发现触控有轻微的偏移、镜像（左右反了）或者缩放不准，说明矩阵可能需要微调。

TransformationMatrix矩阵"a

i"的每个参数都有几何意义，但调整起来比较数学。

对于绝大多数简单旋转场景，上面提供的四个标准矩阵已经足够。

如果遇到复杂情况（比如屏幕本身还有镜像），可能需要查阅更详细的资料来构造矩阵。

一个更实用的方法是使用xinput命令来动态测试矩阵值，而不用反复重启。

先用xinput

--list-props

[id]找到TransformationMatrix的属性编号，然后用xinput

--set-prop临时设置，测试效果满意后，再写入配置文件。

5.

疑难杂症与进阶技巧

在实际折腾中，你可能会遇到一些不那么标准的情况。

这里分享几个我踩过的坑和对应的解决办法。

情况一：修改config.txt和xrandr都无效。

这可能是因为你的屏幕使用了特殊的驱动或帧缓冲（framebuffer）设置。

可以尝试在/boot/config.txt中注释掉任何与hdmi_或display_相关的特殊模式设置，让系统自动识别。

对于某些屏幕，可能需要添加display_rotate参数（注意，不是lcd_rotate）来尝试。

情况二：触控完全无法被识别（xinput

list里找不到）。

首先确认触摸屏的硬件连接（如USB）是否正常。

然后检查内核是否加载了对应的触摸屏驱动。

可以运行dmesg

grep

input查看启动日志。

可能需要手动安装或编译特定的触摸屏内核模块。

情况三：使用Wayland显示服务器。

较新版本的树莓派OS可能默认使用Wayland。

Wayland下xrandr和xinput可能不工作。

旋转显示需要在图形设置界面中完成，或者使用Wayland的合成器（如Sway）的配置。

触控旋转的逻辑也完全不同，通常需要通过环境变量或桌面环境特有的配置来设置。

情况四：无桌面环境（纯命令行）下的旋转。

如果你运行的是树莓派Lite版（无桌面），旋转控制台（TTY）显示方向，需要在/boot/config.txt中使用display_rotate参数。

触控不适用，但如果你连接了USB触摸屏并在控制台使用，那将是另一个复杂的话题，通常涉及修改Linux输入子系统的配置。

最后，也是最关键的一点：备份你的配置文件。

在修改/boot/config.txt或任何X11配置之前，先复制一份。

这样即使配置出错导致无法启动，你还可以通过读卡器在别的电脑上恢复文件。

屏幕旋转的配置就像一把钥匙，一旦找对了，你的树莓派项目就能以最舒适的姿态运行，无论是做智能相框、控制面板还是便携终端，都能得心应手。