Stray for Mac 详细使用指南

Stray 是一款专为 macOS 设计的现代化、轻量级代码编辑器，以其极致的性能、优雅的界面和高度可定制性而受到开发者青睐。它专注于提供流畅的编码体验，尤其适合前端开发、脚本编写及日常文本处理。本文将深入介绍其核心界面、完整工作流程及实用技巧。

一、核心界面与工作区详解

Stray 的界面遵循简约设计哲学，主要分为以下几个区域：

• 标题栏与菜单栏：顶部标准 macOS 栏，包含所有功能菜单。
• 侧边栏（资源管理器）：位于窗口左侧，默认通过快捷键 Cmd+Shift+E 或点击侧边栏图标打开/关闭。它以树状结构显示当前打开的项目文件夹中的所有文件和子文件夹，是项目导航的核心。
• 编辑区：窗口中央的核心区域，用于显示和编辑打开的文档。支持多标签页（Tab）管理，可通过 Cmd+T 新建标签页，Cmd+W 关闭当前标签页。
• 状态栏：位于窗口底部，显示当前文件的行列信息、编码格式、语言模式、Git 分支状态（如果项目在 Git 仓库中）等。
• 面板区：通常位于编辑区下方或右侧，可通过菜单栏的“查看”->“面板”打开。包含：
  • 问题面板：显示代码中的错误和警告。
  • 输出面板：显示任务运行或扩展的输出结果。
  • 调试控制台：用于调试代码。
  • 终端：集成终端（Ctrl+` 打开/关闭），可直接在编辑器内执行命令行操作。
• 活动栏：位于最左侧的垂直图标栏，包含资源管理器、搜索、源代码管理（Git）、扩展、调试等主要功能的快捷入口。

二、完整操作流程：从创建项目到导出

1. 启动与初始设置

首次启动 Stray，会显示一个欢迎页面，提供“新建文件”、“打开文件夹”等快速入口。建议关闭欢迎页后，先进行基础偏好设置：

步骤： 点击菜单栏 Stray -> 偏好设置 -> 设置（或使用快捷键 Cmd+,），进入设置界面。此处可配置字体、主题、自动保存、缩进等。

2. 创建/打开项目

Stray 以“文件夹”为单位管理项目。

• 新建项目： 点击菜单栏 文件 -> 新建窗口（Cmd+Shift+N），然后点击 文件 -> 打开文件夹…（Cmd+O），选择一个空文件夹或创建新文件夹并打开。
• 打开现有项目： 直接使用 Cmd+O，选择项目根目录文件夹。

打开后，侧边栏会显示该文件夹的完整结构。

3. 创建与编辑文件

• 新建文件： 在侧边栏右键点击目标父文件夹，选择“新建文件”，或直接使用快捷键 Cmd+N 创建未命名文件后再保存。
• 保存文件： 首次保存使用 Cmd+S，选择位置和文件名。文件后缀名（如 .js, .html, .py）会自动决定语言模式和高亮方案。
• 编辑操作： 在编辑区直接输入。常用快捷键：
  • 复制行：Cmd+Shift+D
  • 删除行：Cmd+Shift+K
  • 上下移动行：Option+↑/↓
  • 行注释/取消注释：Cmd+/
  • 格式化文档：Option+Shift+F

4. 搜索与导航

• 文件内搜索： Cmd+F 打开搜索框，输入关键词进行查找。Cmd+G 查找下一个。
• 全局搜索（跨文件）： Cmd+Shift+F 打开搜索面板，可指定搜索范围和过滤条件。
• 快速跳转到文件： Cmd+P 打开“快速打开”面板，输入文件名的一部分即可快速定位并打开。
• 跳转到定义： 将光标放在函数或变量上，按 F12。

5. 使用版本控制（Git）

如果打开的文件夹是一个 Git 仓库，活动栏的“源代码管理”图标会显示更改数量。

• 查看更改： 点击活动栏的源代码管理图标（或 Ctrl+Shift+G），侧边栏会变为源代码管理面板，显示所有更改的文件。
• 暂存与提交： 在更改文件旁的“+”号点击可暂存。在顶部输入框输入提交信息，点击勾号图标或按 Cmd+Enter 提交。
• 推送与拉取： 在面板底部有同步、拉取、推送等按钮。

6. 运行与调试

对于支持的语言（如 Python, JavaScript），可以配置运行任务。

• 运行简单脚本： 使用集成终端（Ctrl+`）直接输入命令运行，如 python script.py。
• 配置调试： 点击活动栏的“运行和调试”图标（或 Cmd+Shift+D），点击“创建 launch.json 文件”，选择环境（如 Node.js, Python）。配置好后，按 F5 开始调试，F9 在光标行切换断点。

7. 最终导出或构建

Stray 本身不直接“导出”成品，但可以通过集成工具完成构建。

• 使用终端构建： 对于前端项目，在终端运行 npm run build 等命令。
• 配置任务： 点击菜单栏 终端 -> 运行任务…，可以配置并运行自定义的构建任务（如通过 Gulp, Make 等）。
• 保存所有文件： 在构建前，使用 Cmd+Option+S 保存所有已打开的文件。

三、常用功能进阶技巧

1. 多光标编辑

• 按住 Option 键并用鼠标点击，可以添加多个光标。
• 选中一个词后，按 Cmd+Shift+L 可以为所有匹配项添加光标。
• 按住 Option 并拖动鼠标，可以进行列选择（矩形选择）。

2. 代码片段与快速输入

输入语言特定的前缀后按 Tab 键可以快速展开代码片段。例如，在 HTML 文件中输入 ! 然后按 Tab，会自动生成 HTML5 基础结构。

3. 命令面板（万能操作入口）

按 Cmd+Shift+P 打开命令面板，输入任何功能名称（如“更改语言模式”、“重命名符号”）即可快速执行，无需记忆菜单位置。

4. 用户代码片段自定义

通过 Cmd+Shift+P 输入“配置用户代码片段”，选择语言，即可在打开的 JSON 文件中定义自己的代码片段。

四、常见问题与解决方案

问题1：侧边栏文件列表不刷新

现象： 在外部新增或删除了文件，侧边栏没有立即显示变化。
解决： 右键点击侧边栏空白处，选择“刷新”，或使用快捷键 Cmd+R（焦点在侧边栏时）。

问题2：终端无法输入或启动失败

现象： 按 Ctrl+` 后终端面板空白或无响应。
解决： 检查默认 Shell 设置。前往 Stray -> 偏好设置 -> 设置，搜索“terminal.integrated.shell.osx”，确保其路径正确（如 /bin/zsh 或 /bin/bash）。

问题3：文件编码显示乱码

现象： 打开某些文本文件时显示乱码。
解决： 点击状态栏右下角的编码（如“UTF-8”），选择“通过编码重新打开”，尝试选择正确的编码（如 GBK, GB2312）。

问题4：扩展安装缓慢或失败

现象： 在扩展商店下载安装扩展时卡住。
解决： 检查网络连接，或尝试更换扩展商店的下载镜像。可通过设置 “extensions.gallery.proxy” 进行配置。

五、Stray for Mac 快捷键汇总表