Sublime Text 使用配置

认识 Sublime 还是从 Markdown 书写工具开始的，Sublime Text 3 版本用起来也没什么大问题了。同时支持 Windows 和 Mac 版本。当前未注册版没有试用的时间限定。其实这么优秀的软件，付费注册支持一下也是完全应当的。

最初 Sublime 给我印象深刻的地方在于其多行编辑功能（Selection > Split into Lines）。这个功能对于 API 接口测试 来说很实用，因为其中重要的任务之一就是 数据准备，使用 Sublime 做数据处理是小菜一碟。

• Sublime Text 3 documentation index
• Sublime Text Power User Book
• Sublime Text Unofficial Documentation
• package control：可以经常看看有什么好用的插件；

安装 Sublime Text 3

• 下载，当前最新 3103。
• 安装都没什么可说的；

安装 package control

The Sublime Text package manager that makes it exceedingly simple to find, install and keep packages up-to-date.

使用 Sublime 的优势就在于她的各类 packages 很多，所以很有必要安装这个 package control。

按照 installation 说明 进行安装即可；

1. 打开控制台：菜单 View > Show Console，然后输入提供的脚本后回车，会自动下载 Package Control.sublime-package 以及所依赖的包，你可以通过菜单 Preferences > Browse Packages 在文件夹 Installed Packages 下看到所安装的各类包；
   示例：在 Windows 7 下，~\AppData\Roaming\Sublime Text 3\ 是数据目录，有 Installed Packages，Local，Packages 三个子目录；

2. 重启 Sublime

   
   Paste_Image.png

注意：安装 package 后，尽管有的 package 可以直接生效，但最好重启一下 Sublime 以确保生效；

安装使用 MarkdownEditing（选用 MultiMarkdown）

• open Package Control's Command Palette
  Control + Shift + P (Windows)，Command + Shift + P (on Mac)，或者通过菜单 Tools > Command Palette。

• 输入 install package 回车

• 输入 MarkdownEditing 回车搜索、下载、安装完成后，重启 Sublime；

• 打开一个 markdown 文件（通常后缀 .md）

  • 菜单 View > Syntax > Open all with current extension as...，勾选 MarkdownEditing 下的 MultiMarkdown，则以后 .md 文件都会使用 Sublime 打开，并采用 MultiMarkdown 语法；
  • 菜单 View > Syntax，勾选 MarkdownEditing 下的 MultiMarkdown，就是对当前文件的语法设置；

• Sublime 内置支持 Markdown，也可以不安装 MarkdownEditing；

• 默认配置文件
  # GitHub flavored Markdown 的配置
  Packages/User/Markdown.sublime-settings
  # MultiMarkdown 的配置
  Packages/User/MultiMarkdown.sublime-settings

• 修改配色方案
  可以直接修改 Packages/User/MultiMarkdown.sublime-settings 文件，加一句（使用她自己的配色方案对语法的支持最好）：

    {
        "color_scheme": "Packages/MarkdownEditing/MarkdownEditor-Dark.tmTheme",
    }

或者菜单 * Preferences > Packages Settings > Markdown Editing > MultiMarkdown Settings - User* 打开文件修改；

文件内容看起来是这个样子的（wrap_width 设置太小会导致折行）：
```
{
    "enable_table_editor": true,
    "wrap_width": 800,
    "color_scheme": "Packages/MarkdownEditing/MarkdownEditor-Dark.tmTheme",
    "extensions":
    [
        "mmd",
        "md"
    ]
}
```

安装使用 Markdown Table Editor 表格编辑器（好用）

• 安装：方法同上，即搜索安装 Table Editor；
• 通过 Tools > Command Palette 来启动使用 Table Editor；
  输入：Table Editor: Enable for current syntax 使得 MultiMarkdown 的编辑都启用 Table Editor，也就是在文件 Packages/User/MultiMarkdown.sublime-settings 中加一句："enable_table_editor": true,。

表格编辑方法

• 表头像往常一样自己输入；
• 在第二行输入 |- 后按 Tab 键即可自动补齐，以后像在 Excel 表中一样使用 Tab 键；
  | Name | Phone |
  |-
• 使用 Alt + Shift + 左箭头：可删除当前列；
• 使用 Alt + Shift + 右箭头：插入一列，当前列右移；
• 使用 Alt + Shift + 上箭头：删除当前行；
• 使用 Alt + Shift + 下箭头：插入一行，当前行下移；
• 使用 Alt + 左右箭头：当前行左右移；
• 使用 Alt + 上下箭头：当前行上下移；
• 详见 Table Editor Usage；

将 csv 格式转为 markdown 表格

可能因为中文输入法等应用的热键冲突的原因，作者提供的 快捷键方法 并不好用，参考 CSV region into table 改为在 Command Palette 中使用命令解决。
加一个文件：Packages/User/Default.sublime-commands，存放用户自定义的命令（如下）：

[
    { "caption": "Table Editor: Convert csv to table", 
      "command": "table_editor_csv_to_table"}
]

选中 csv 片段，打开 Command Palette，找到 Table Editor: Convert csv to table 即可转换。

如果你熟悉 Selection > Split into Lines 命令，自己手工转换一下也不难。

安装 Git

Git
Plugin for some git integration into sublime text

• 经常编写 .md 接口文件的，安装 Git 插件就会非常方便，修改后即可在一个环境下流畅地完成任务；
• 在 Command Palette（命令板）中安装 Git。
• git pull，git status，git diff，git commit，git push 都是好用的。

安装 Material Theme（Sublime 主题）

• 在 Command Palette（命令板）中安装 Material Theme。
• 启用 Material Theme
  Preferences > Setting - User：

    "theme": "Material-Theme.sublime-theme",
    "color_scheme": "Packages/Material Theme/schemes/Material-Theme.tmTheme",

• 重启 Sublime

安装 Markmon：real-time markdown preview

有点复杂，请参考：Sublime の 如何实时预览 markdown 文件？

注意事项

• 目录名 | 文件名 | Tab 标签 の 显示方框乱码问题；

  
  目录和文件名乱码问题
  • 原因：Control Panel > Display，Change the size of all items，如果不是默认的 100%，则会出现这个问题；
  • 解决：菜单 Preferences > Settings - User，加一项：{ "dpi_scale": 1.0, } 即可；dpi scale 是 一个问题；
• 文件编码默认是 UTF-8，请保持这个编码，以免中文乱码；
  打开 Preferences > Settings - Default 能看到这个配置项；
• 配置文件大多都是 json 格式，请熟悉 json；
• Preferences > Settings - User：加一项 "translate_tabs_to_spaces": true,

关于文件编码

• 我们的所有项目都使用 UTF-8，包括源代码、API md 文件等；
• 在 Windows Command Prompt 下，查看比较 UTF-8 文件会出现乱码；
  因为默认 code page id 为 936（gb2312），所以会乱码；
• 改变代码页方法
  1）将 cmd 字体改为 "Lucida Console"：右键点击标题栏，选择 Properties > Fonts 即可；
  2）改变代码页：chcp 65001； 65001 是 UTF-8 的代码页 id；
  chcp 可查看当前代码页编码；
  3）Power Shell 可参照执行；
• 如果有 Git Bash，建议你直接使用 Git Bash，那里什么问题都没有。这一切源于 Windows 把 UTF-8 作为二等公民来看待。

备注

• Sublime 默认会记住你做的所有选择，比如对于一个文件所做的 View > Syntax 选择。
• 查看 Preferences > Settings - User 自定义偏好；

参考

• Sublime Text tips for Markdown table editing

---