初学者教程

Spacemacs 的强大之处在于其高效的按键绑定。因为它是基于 Emacs 构建的，所以我们将使用 Emacs 约定进行键绑定符号。最重要的修饰键是：

• 
  SPC = Space ，用作 Vim 编辑风格中的前导键。
• 
  RET = Return （也称为Enter ）
• C- = Ctrl
• 
  M- （“元”）= Alt
• S- = Shift

修饰键可以按顺序使用，也可以通过同时按两个键作为键和弦使用。 SPC 1是按键序列的表示法，表示先按Space ，然后按1 。调和弦是通过在调之间写一个-来表示的。因此Cc意味着按Ctrl和字母 c同时。主和弦和音序也可以组合： Cc a表示“首先同时按Ctrl和c ，然后按a ”。 Cc Ca意思是“首先同时按下Ctrl和c ，然后同时按下Ctrl和a ”。

本文档假设您选择“Vim”编辑风格并进行相应注释。如果您选择 Emacs 编辑方式，只需将所有以SPC开头的命令中的SPC替换为Mm即可。

（注意：可以设置其他修饰键，例如Super ，用小写的s-表示，但这在 Spacemacs 中很少需要）。

写作（或编程）通常不是添加单词和行直到完成的简单线性过程。这项工作的重要部分至少包括编辑文本：删除和重写部分内容、移动句子或跳到较早的点以修复差异。

例如，删除某一行的最粗暴的方法是将鼠标移动到 有问题的行，单击该行，然后按删除它 反复退格。

这是缓慢且低效的，因为您必须 把你的手从键盘上拿开，因为反复按退格键 需要时间。你花在按键上的时间越多，你花费的时间和精力就越多。 浪费了。

为了加快编辑速度，许多编辑器使用关键和弦来完成常见的编辑任务： Control-c用于复制等。然而，这些类型的快捷方式往往有两个问题。首先，您必须同时按下两个键，这更难协调，因此比按顺序按键要慢。

第二， 您通常必须广泛使用最弱的手指（小指）并弯曲 您的手腕处于不符合人体工程学的位置，这对许多人来说不舒服并且存在风险 从长远来看，会发展为腕管综合症。

相比之下，Spacemacs 使用模式编辑。模态编辑意味着不同 模式用于编辑和编写文本。虽然这听起来很复杂 第一，在实践中可以很快学会，而且一旦学会了是无与伦比的 在速度和人体工程学方面。

我们之前删除某一行文本的示例（a 非常常见的编辑任务）可以在 Spacemacs 中通过简单地导航到 使用j和k （导航键）键并按d查找有问题的行 （“删除”）两次！

您可能已经注意到，这完全是在无需将手指从主行（盲打时手指静止的行）移开且无需使用修饰键的情况下实现的。

Spacemacs 的模态编辑功能源于一个名为Vi 的文本编辑器，因此模态编辑教程称为 eVIl coach。按SPC h T v （即spacebar后跟h 、 T和v ）来熟悉模态编辑。

现在您已经熟悉了编写和编辑文本，是时候将 “太空”进入Spacemacs。因为空格键是最容易使用的键 键盘并由最有力的手指（拇指）按下，这是自然的 启动命令的选择。

您可以将其视为开始菜单 太空麦克斯。

按下空格键后不久，就会弹出一个菜单。此交互式菜单向您显示后续按键可以访问哪些子菜单和命令。浏览此菜单是查找 Spacemacs 新功能的好方法，因此请留意不同的选项！ ESC通常会破坏您不想使用的组合。

因为 Emacs（Spacemacs 的扩展）是在 80 年代开发的 在现代图形用户界面出现之前，Emacs 我们通常所说的“windows”的不同名称：在 Emacs 中，它们是 称为“框架”。

当您从您的电脑启动 Spacemacs 时，会弹出一个框架 桌面快捷方式。框架包含窗口和缓冲区。

窗户是框架划分的视觉空间。默认 是其中之一，但可以分割窗口以允许在一帧中编辑多个文件。 让我们试试这个。按SPC调出菜单。您可以看到不同的字母具有与其关联的不同子菜单，通常带有助记符以便于记忆。字母 w 指定为“windows”：按下它。将打开一个新菜单，其中包含更多选项。

写入字符 / 来分割当前活动的 窗口垂直一分为二。

现在您应该看到本教程的两个窗口，左边的一个应该处于活动状态，从底部的模型行或使用导航键移动光标可以看到这一点。这不是很有用，因为我们可能希望在右侧看到不同的文件。

首先，使用SPC 2激活右侧的窗口。现在右侧的窗口处于活动状态，我们可以为不同的文件打开不同的缓冲区。我们将使用暂存缓冲区，它可以像记事本一样使用。请注意，与其他缓冲区不同，它不会在退出程序时提示您是否要保存所做的更改！按SPC b打开缓冲区菜单，然后按 s 切换到暂存缓冲区。现在您在两个不同的窗口中打开了两个不同的缓冲区，太棒了！您可以在暂存缓冲区上写入一些内容，完成后，请确保暂存窗口处于活动状态并按SPC wd将其关闭。

现在教程窗口填满了整个框架。但是您只关闭了窗口，而不是暂存缓冲区，因此缓冲区在表面下仍然打开。您可以使用SPC TAB在当前缓冲区和最后一个缓冲区之间快速切换：使用此选项几次在教程和临时缓冲区之间切换。 SPC b有更多用于在缓冲区之间切换的选项，例如SPC bb打开所有当前打开的缓冲区的可搜索列表，而SPC bd关闭当前缓冲区。

可以在SPC f助记符下访问文件。您可以使用SPC ff导航到任何文件并按RET打开它。访问最近打开的文件是一项非常常见的任务，可以使用SPC fr完成。编辑后的文件保存为 SPC fs 。

Spacemacs 将其配置划分为称为配置层的独立单元。这些层相互堆叠以实现自定义配置。

默认情况下，Spacemacs 使用名为~/.spacemacs的点文件来控制要加载的图层。在此文件中，您还可以配置某些功能。首先，垂直分割窗口以同时查看本教程和点文件（ SPC w / ）。按SPC fed打开点文件。导航到以“dotspacemacs-configuration-layers”开头的行。以下行有进一步的说明：如果您想熟悉org和git层，请取消注释它们。按SPC h SPC可以找到针对不同语言和工具的更多层。添加的层将在 Spacemacs 重新启动时安装。

有些层需要第三方工具，您必须通过您最喜欢的包管理器安装这些工具。层自述文件将告诉您是否属于这种情况。

您可以通过SPC T n切换主题。这会在当前激活的主题之间循环。您可以通过添加主题megapack 层来找到更多内容，并通过在 dotspacemacs-themes 列表中写入它们的名称来激活它们。

编辑 dotspacemacs-maximized-at-startup 变量从nil到t将启动 Spacemacs 最大化。

使用SPC fs保存对点文件所做的更改，然后使用SPC qq退出 emacs。您可以通过在主屏幕上单击它来返回本教程！

组织模式是 Spacemacs 的最佳功能之一，并且有足够的理由保证 它的用途。

Org 模式的官方描述是“用于记笔记， 快速维护待办事项列表、规划项目和编写文档 和有效的纯文本系统”，但这仅给出了其一小部分内容 多功能性。

如果你进行任何类型的写作，很可能会选择 Org 模式 会让事情变得更容易、更有趣。本教程是在 Org 模式下编写的。

测试它的一些功能。安装Org层并打开本教程。在.emacs.d目录之外的某个位置使用SPC fc创建一个名为test.org副本。按SPC SPC ，写入org-mode并按RET切换到 org-mode来自只写文档模式。

反复按S-TAB并观察这会循环不同标题内容的可见性。在正常模式下按SPC m TT并观察您可以在标题上添加 TODO 标签。 （这可以更改为t ，请参阅组织层文档）。在正常模式下按Mk或Mj ，看看如何快速移动文档的各个部分。

这还不是 Org 模式的皮毛，所以你应该研究一下 org 层与SPC h SPC org了解更多信息。谷歌搜索 Org 模式教程对于查找最有用的功能也非常有帮助！

版本控制意味着跟踪您所做的更改和编辑 你的文件。通常版本控制是通过保存不同版本的 具有不同名称的文档，例如“文档版本13”等。

这是 在很多方面都很粗糙：例如，如果您想重新添加删除的内容， 您必须手动打开该文档的多个过去版本才能找到该文档 与删除的部分，然后将其复制粘贴到最新的文件。更多的 复杂的编辑将会更加困难。

幸运的是，有一个更好的方法。 Git 是最受程序员欢迎的版本控制系统，但它也可以作为 对于撰写学校或科学论文、小说或博客的人有用 帖子也是如此。

安装git层，重新启动Spacemacs并打开你想要版本控制的文件。您可以按SPC gs检查文件的状态。选择文件所在的文件夹。系统将提示您是否要在该文件夹中创建存储库。选择是。您将看到“未跟踪的文件”列表：导航到要跟踪的文件，然后按 s 进入“阶段更改”。系统可能会提示您保存文件：如有必要，请保存。现在新文件需要 已提交：再次按 c 和 c。弹出两个窗口：一个显示更改 自上次编辑（在本例中为整个文档）以来您所做的以及另一个 提示提交消息。写入“Initial commit”，按 ESC 退出回到正常模式，然后按, c确认并退出提交消息。要中止，请按, a 。

现在您知道如何进行提交了。提交保存在（隐藏）.git 文件夹中，该文件夹位于跟踪文件所在的同一文件夹中。您可以以相同的方式进行进一步提交。

Emacs 可以在守护进程模式下使用：守护进程在后台运行并启动客户端。这样新的框架就会立即启动，不会有延迟。 Emacswiki详细介绍了守护进程以及如何将其设置为在启动时自动启动。

这在 Spacemacs 之外也很有用！

SPC ?向您显示当前主要模式中的键绑定，这通常很有帮助。如需故障排除，请按SPC hf参阅常见问题解答。更多帮助可在SPC h下找到，通过SPC h SPC您可以访问全面的 Spacemacs 文档，包括本教程和图层文档。

如果在文档中找不到答案，可以使用Gitter 聊天来提问。要详细了解 Spacemacs 的功能，还可以观看 Youtube 上 Eivind Fonn 的Spacemacs ABC 系列。自从视频上传以来，一些按键绑定已经发生了变化，但看到某人在行动有助于发现一些有用的技巧，否则这些技巧可能会被错过。