快速入門

概覽

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 成為您的新導航好夥伴
- 更清潔的工作區
- 更快的上下文切換

💡 專業提示：並非每個人的編碼風格都相同！我們建議嘗試禪模式，看看它是否與您的工作流程產生共鳴。您完美的編碼環境只需幾個切換即可達成！🌈✨