Linux下的xrandr命令详解

xrandr 是 Linux 下用于配置显示器的命令行工具（基于 X Window System），可调整分辨率、刷新率、屏幕旋转、多显示器布局等。以下是详细说明和常见用法：

临时设置分辨率：xrandr -s 1024x768

1. 基础命令

🔹 查看当前显示配置

xrandr

输出示例：

Screen 0: minimum 320 x 200, current 1920 x 1080, maximum 8192 x 8192
HDMI-1 connected primary 1920x1080+0+0 (normal left inverted right x axis y axis) 527mm x 296mm
   1920x1080     60.00*+  50.00    59.94
   1280x720      60.00    50.00    59.94
   1024x768      75.03    70.07    60.00
DP-1 disconnected

• connected/disconnected：显示接口状态。
• primary：主显示器。
• *：当前分辨率，

• +：推荐分辨率。
  

2. 常用场景与配置示例

场景1：设置分辨率

xrandr --output HDMI-1 --mode 1920x1080 --rate 60

• --output：指定显示器接口（如 HDMI-1）。
• --mode：分辨率（必须是 xrandr 列表中支持的值）。
• --rate：刷新率（可选，如 60）。

场景2：扩展屏幕（多显示器）

xrandr --output HDMI-1 --auto --right-of DP-1

• --auto：自动启用接口并使用推荐分辨率。
• --right-of/--left-of/--above/--below：相对位置。

场景3：镜像显示（复制屏幕）

xrandr --output HDMI-1 --same-as DP-1 --mode 1920x1080

场景4：关闭/启用显示器

xrandr --output HDMI-1 --off    # 关闭
xrandr --output HDMI-1 --auto   # 重新启用

场景5：旋转屏幕

xrandr --output HDMI-1 --rotate left      # 向左旋转90度
xrandr --output HDMI-1 --rotate inverted  # 180度倒置
xrandr --output HDMI-1 --rotate normal    # 恢复默认

场景6：自定义分辨率（需先添加模式）

# 生成新分辨率模式
cvt 2560 1440 60
# 添加模式并应用
xrandr --newmode "2560x1440_60.00" 312.25 2560 2752 3024 3488 1440 1443 1448 1493 -hsync +vsync
xrandr --addmode HDMI-1 2560x1440_60.00
xrandr --output HDMI-1 --mode 2560x1440_60.00

3. 典型配置文件示例

将常用配置写入 ~/.xprofile 或 ~/.config/autostart/xrandr.sh（开机自动执行）：

#!/bin/bash
# 双显示器：主屏在左，副屏在右
xrandr --output DP-1 --mode 2560x1440 --primary --left-of HDMI-1 --mode 1920x1080

4. 常见问题

❌ 报错：Configure crtc X failed

• 原因：分辨率/刷新率超出硬件支持范围。
• 解决：使用 xrandr 列出的有效参数，或通过 cvt 生成合法模式。

❌ 配置重启后失效

• 持久化方案：
  1. 写入 ~/.xinitrc（StartX 环境）。
  2. 使用桌面环境（如 GNOME/KDE）的显示设置工具。

❌ NVIDIA 显卡兼容性问题

• 改用 nvidia-settings 工具调整。

5. 其他实用技巧

• 获取显示器名称：

  xrandr --listmonitors

  

• 调整亮度（需要硬件支持）：

  xrandr --output HDMI-1 --brightness 0.7  # 范围 0.1~1.0

总结表格