omacom/omarchy - 快速上手

由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名

项目介绍快速开始学习路径贡献者 449 增长趋势 Commit 历史代码统计生态关系项目时间线项目竞品上榜历史

5分钟快速开始 Omarchy Linux 发行版

Omarchy 是一个由 DHH 创建的、注重设计与效率的 Linux 发行版，通过一条命令即可体验其预配置的优雅环境。

环境要求

支持的操作系统

macOS Windows Linux

所需工具

Git

用于克隆项目仓库

必需

USB 闪存驱动器

用于创建可引导安装介质（如果进行全新安装）

操作步骤

获取 Omarchy 安装脚本

首先，你需要获取官方的安装脚本。打开你的终端（如 macOS 的 Terminal、Windows 的 PowerShell/WSL 或任何 Linux 终端），并执行以下命令。

克隆 Omarchy 项目的 Git 仓库到本地。

git clone https://github.com/omacom/omarchy.git

预期结果：：终端将显示克隆进度，最后显示 'done.'。

请确保你的网络连接正常，且已安装 Git。

进入项目目录并运行安装程序

进入刚刚克隆的目录，并执行安装脚本。这个脚本会引导你完成后续设置。

进入 omarchy 项目目录。

cd omarchy

运行安装脚本。这将启动交互式设置过程。

./install.sh

预期结果：：屏幕上将出现欢迎信息和一系列交互式问题，例如选择键盘布局、时区、用户名和密码等。

安装脚本是交互式的，请按照屏幕提示进行操作。如果你是全新安装到硬盘，请谨慎选择磁盘分区。

完成基本设置并启动

根据安装程序的提示完成所有设置。安装程序将自动配置系统，安装所有必要的软件包，并应用 Omarchy 的主题和配置。

预期结果：：安装完成后，系统会提示你重启。重启后，你将直接进入美观的 Omarchy 桌面环境。

整个安装过程（包括下载软件包）所需时间取决于你的网络速度和计算机性能。

验证安装成功

重启后登录你的用户账户，检查系统是否正常工作并展示其特色功能。

成功登录后看到带有顶部状态栏（包含时钟、系统状态等）的桌面环境。

尝试按下 'Super' 键（通常是 Windows 键或 Command 键），应能打开 Omarchy 的应用程序启动器。

打开终端（通常按 'Super + T'），应出现一个配置好的终端窗口。

快速提示

热键

Omarchy 的核心是热键驱动。按下 'Super + ?' 可以查看可用的热键列表，这是提高效率的关键。

应用

Omarchy 预装了 Neovim 作为终端编辑器。尝试在终端中输入 'nvim' 来体验它。

文档

详细的用户手册在项目的 'manual/' 目录中，可以离线阅读。

常见问题

安装脚本执行失败，提示缺少依赖。

请确保你的系统是较新版本的 Ubuntu 或其衍生版（如 Linux Mint）。Omarchy 基于此构建。尝试先运行 'sudo apt update && sudo apt upgrade' 更新你的基础系统，然后重试。

重启后无法登录图形界面，只能看到命令行。

这可能是显示驱动问题。尝试登录命令行，然后运行 'sudo systemctl restart gdm' (或 sddm，取决于安装) 来重启显示管理器。如果问题持续，请查看日志 '/var/log/Xorg.0.log' 或 '/var/log/syslog' 获取线索。

某些热键或功能不工作。

请首先查阅 'manual/' 目录中的用户手册，特别是 'Hotkeys' 和 'Troubleshooting' 章节。手册是解决大多数配置和使用问题的权威来源。

下一步

阅读完整手册

深入 'manual/' 目录，系统性地了解 Omarchy 的所有特性、配置和应用程序。

个性化你的主题

Omarchy 支持主题系统。尝试通过热键或 CLI 工具切换不同的视觉主题。

探索开发工具

查看手册中关于 'Development Tools' 的部分，了解如何配置你的编程环境。

参与社区

访问项目 GitHub 页面，查看 Issues 和 Discussions，参与社区交流或贡献代码。