快速入门

概述

Spck Editor 是一款移动代码编辑解决方案，具有为开发者设计的多种变体。

版本

Spck Editor (免费版)

基本的移动代码编辑功能
通过 isomorphic-git 实现可移植的 git 库集成

Spck Editor Lite

价格：一次性付款功能：

自定义代码片段
预测键盘
独家霓虹主题

Spck for NodeJS

平台：Android 独占 主要功能：支持 NodeJS 的集成终端

浏览器版本

可嵌入任何网站
轻量级代码编辑界面

主要特性

移动优先设计
Git 集成
跨平台兼容性

术语

术语	描述
导航菜单	指移动设备侧边菜单上的第一个标签，此菜单在浏览器版本或平板模式下不可用
文件菜单	指侧边菜单或侧边栏上的 File 标签
扩展键盘	移动设备上有一个带有常用编码符号的扩展键盘，可快速插入
触控键盘	通常指包含箭头键、Tab 键等的一行按键
触控操作栏	这是在移动/触控设备上选择文本时弹出在光标上方的浮动菜单
触控光标	在移动/触控设备上选择文本或光标处于活动状态时出现在屏幕上的光标
平板模式	指可在较大触控设备（如平板）上启用的设置
⌘ 键	触控键盘上的此符号与 Windows 上的 Ctrl 键或 Mac 上的 Command 键相同
⌥ 键	触控键盘上的此符号与 Windows 上的 Alt 键或 Mac 上的 Option 键相同

键盘快捷键

概述

通过这些方便的键盘快捷键解锁闪电般的效率！虽然不是完整目录，但这些精华将大幅提升您的生产力，让导航变得轻而易举。

主要亮点

非详尽列表：精选最实用的快捷键
目的：通过快速、直观的命令提升您的工作流程
优势：节省时间，减少对鼠标的依赖

💡 专业提示：记住这些快捷键，看着您的生产力飙升！🌟

您可以通过转到 Settings > Editor > Keyboard Shortcuts 查看完整的快捷键列表。

高级用户还可以直接从扩展键盘访问键盘快捷键，或使用快捷键 ⌘ K

通过启用 Settings > Touch > Show ⌘ Key 和 Settings > Touch > Show ⌥ Key 启用 Ctrl/Command 键（⌘）和 Alt/Options 键

编辑器

快捷键	操作
⌘ A	全选
⌘ C	复制
⌘ V	粘贴
⌘ X	剪切
⌘ Z	撤消
⌘ ⇧ Z	重做
⌘ D	复制行
⌘ /	注释/取消注释行
⌥ F	格式化代码
⌘ F	查找
⌘ G	查找下一个（适用于选定文本）
⌘ ⇧ G	查找上一个
⌘ L	跳转到行

快速操作

快捷键	操作
⌘ ⇧ C	Git 提交
⌘ O	打开最近文件
⌘ ⇧ P	启动项目预览
⌘ P	切换文件预览（SVG、Markdown）
⌘ K	Supporter+：打开快捷键

触控设置

扩展键盘

扩展键盘是为触控设备设计的符号键盘。
通过长按按键可以访问其他按键/符号，从而打开选项菜单。
您可以在 Settings > Touch > Extra Keyboard 菜单中启用或禁用它。

💡 专业提示：请参阅 高级编辑 了解与扩展键盘兼容的环绕文本提示。

触控键盘

触控键由一行按键组成，包括箭头键、Command 键和其他常用按键。
此功能在触控设备上可用。
您可以在 Settings > Touch > Touch Keyboard 部分切换打开或关闭。

💡 专业提示：您可以通过调整设置自定义此键盘上的单个按键。

触控操作栏

选择文本时，会出现带有复制、剪切和粘贴选项的操作栏。
此功能可以在 Settings > Touch > Touch Action Bar 中启用或禁用。

触控光标

选择文本或光标处于活动状态时出现的屏幕光标。
此功能可以在 Settings > Touch > Touch Cursors 中启用或禁用。

💡 专业提示：除非您将鼠标/指点设备与移动设备配对，否则不建议禁用此功能。禁用触控光标可以改善编辑时的屏幕可见性，并在使用外部指点设备时改善编辑体验。

预测键

预测键是一个高级功能，取代了标准的扩展键盘。
提供单次触碰的符号输入，而不必在常规扩展键盘中长按并选择
按键按文件中特定位置出现符号的统计频率排序。
可以在 Settings > Touch > Predictive Keyboard 中打开或关闭。

💡 专业提示：预测键取代了常规扩展键盘，某些用户可能更喜欢常规键盘。预测键是编辑器 Lite 版本中的默认选项，可以将其关闭以恢复常规扩展键盘。

文件导航

概述

在文件之间导航有多种方法
您可以使用侧边菜单中的文件浏览文件
您可以使用面包屑从当前文件目录开始浏览文件
您可以打开最近文件 Ctrl-O 来快速搜索文件
您可以使用文件侧边菜单中的“Locate”图标快速定位当前文件
源代码控制和搜索侧边菜单也提供了在文件之间导航的独特方式

文件标签管理

标签行为

文件最初打开时会自动取消固定
进行编辑时标签会被固定

标签排序选项

文件可以按以下方式排序：

字母顺序
文件扩展名
文件路径

替代导航渠道

源代码控制菜单：通过版本控制上下文导航文件
搜索菜单：根据搜索条件查找和访问文件

💡 专业提示：可以在 Settings > Appearance > Show File Tabs 中关闭文件标签视图。请参阅 禅模式 了解如何在较小设备上最大化屏幕空间。

高级编辑

高效使用预测键盘

基本选择

双击以选择单词或文本块

环绕文本

使用括号或引号对快速环绕选定的文本：

圆括号：( )
方括号：[ ]
花括号：{ }
单引号：' '
双引号：" "

导航和编辑

文本搜索

⌘ G：查找下一个实例
⌘ ⇧ G：查找上一个实例

缩进

选择文本块
按 Tab 缩进

多光标

快速设置

使用 Alt/Option 键启用多光标！✨
导航到 Settings > Touch > Show ⌥ Key 来激活

使用方法

选择 ⌥ 和 ⌘ 键
单击以将光标放置在您想要的确切位置
轻松同时编辑多行！💻

💡 专业提示：多光标编辑 = 闪电般快速的代码转换！⚡️ 也可以使用命令面板命令 Add Cursor Above 和 Add Cursor Below 添加多光标，这将在当前光标位置的正上方或正下方添加一个光标。

Git 限制

概述

编辑器的 Git 集成由 isomorphic-git 提供支持，这是 Git 的纯 JavaScript 实现，完全在客户端运行。虽然这使得无需服务器即可直接在浏览器和移动设备上进行 Git 操作，但它伴随着在沙盒化 JavaScript 环境中运行 Git 所固有的几个约束。

内存限制

操作系统通常将移动应用程序限制在约 50MB 的内存。
对大型仓库的 Git 操作可能会超出此预算，导致应用程序被终止。
读取大型 pack 文件（.git/objects/pack/ 中的 .pack 文件）需要一次性将大量内容加载到内存中，这在内存受限的设备上不可行。
因此，在移动设备上 克隆或操作大型仓库可能会因内存不足错误而失败。

💡 提示：对于大型仓库，请尽可能使用浅克隆（shallow clone），或考虑使用仓库的较小子集。

符号链接兼容性

出于安全原因，浏览器/移动沙盒中 本地不支持 符号链接（symlinks）。
编辑器使用 模拟符号链接 表示作为变通方法，以便仍然可以检出包含符号链接的仓库。
此模拟可能与期望真实文件系统符号链接的工具存在 兼容性问题（例如，某些构建工具、包管理器或在运行时解析符号链接目标的脚本）。
严重依赖符号链接的仓库可能不会与本地 Git 检出表现得完全相同。

使用 CLI 作为替代方案

这些限制仅适用于应用程序内的 Git 客户端。它们不会影响 Spck CLI，后者使用主机系统上的 本地 Git 二进制文件：

没有 50MB 内存上限——Git 操作仅受您机器可用内存的限制。
大型 pack 文件和大型仓库本地处理。
真正的符号链接按预期工作，与其他工具完全兼容。
所有 Git 功能和 plumbing 命令均可用，而不仅仅是 isomorphic-git 实现的子集。

💡 专业提示：如果您经常使用大型仓库或依赖符号链接的项目，使用 Spck CLI 进行 Git 操作（clone、fetch、push）——同时仍然在移动应用程序中编辑文件——可以让您获得两全其美的效果。

🌟 禅模式

概述

禅模式是一种令人愉悦的、最大化空间的编辑器配置，旨在改变您在紧凑显示屏上的编码体验。

禅模式包括：

在设置中关闭 Show Line Numbers
关闭 Show File Tab
关闭 Touch Action Bar

主要功能

🧘‍♀️ 最大化屏幕空间

告别行号！
- 释放宝贵的水平空间
- 防止文本感觉拥挤
- 拥抱简洁、极简的外观

🎨 精简界面

操作栏最小化
- 告别杂乱的工具栏
- 利用替代输入方式：
  - 扩展键盘的粘贴/剪切按钮
  - 键盘快捷键（Ctrl-C/Ctrl-V）

📂 简化导航

消除文件标签
- Ctrl-O 成为您的新导航好伙伴
- 更清洁的工作区
- 更快的上下文切换

💡 专业提示：并非每个人的编码风格都相同！我们建议尝试禅模式，看看它是否与您的工作流程产生共鸣。您完美的编码环境只需几个切换即可达成！🌈✨