快速定位

最短工作流

安装（Linux / macOS）

# 一行安装
curl https://raw.githubusercontent.com/sinelaw/fresh/refs/heads/master/scripts/install.sh | sh

# 安装完成后直接运行
fresh

SSH 远程编辑

# 直接编辑远程文件（和本地一样流畅）
fresh deploy@prod:/etc/nginx/nginx.conf

# Ctrl+P 模糊搜索远程文件
# 保存通过 SSH diff 传输（只传改动，不传整文件）

用作 Git 编辑器

git config --global core.editor "fresh --wait"
# fresh --wait 会阻塞直到文件关闭，适合 commit、rebase 等

Daemon 模式（持久会话）

# 启动命名守护进程
fresh -a myproject

# 在运行中的 daemon 里打开文件
fresh --cmd daemon open-file myproject src/main.rs:42

# Ctrl+Z 挂起后仍保持连接，断线自动重连

核心能力

🚀 极速启动与响应

• 即时启动：程序启动时间毫秒级
• 输入无延迟：输入即显示，无渲染等待
• 内存占用低：相比 Electron 编辑器节省大量内存
• 多 GB 文件：打开 GB 级大文件不阻塞 UI
• SSH 编辑：只传输 diff，远程大文件小改动仍然流畅

🎯 编辑体验

• 多光标编辑：终端中体验最流畅的多光标
• 多选与宏：Keyboard macros 支持复杂批量操作
• 块选与排序：Block selection、sort、case conversion
• Vim 模式：可选 Vim keybinding
• 内联诊断：Inline LSP diagnostics

🔍 搜索与替换

• 项目级搜索替换：Project-wide grep & replace
• 跨未保存缓冲区：即使文件未保存也能搜到
• Fuzzy 文件查找：Ctrl+P 模糊匹配
• Git Grep：集成 git grep

🔀 Git 集成

• Split-panel Review：左面板 staged / unstaged / untracked，右面板选中 diff
• Hunk 级操作：stage / unstage / discard 单个 hunk
• 行级注释：Review notes，导出 Markdown
• Side-by-side Diff：文件对比视图
• Git Gutter：行号侧边栏显示修改状态
• Git Log Viewer：集成 git log

🧠 LSP 集成

• 多 LSP 服务：每种语言可运行多个 LSP（pylsp + pyright）
• 自动检测项目根目录：通过 Cargo.toml、package.json 等标记
• 开箱即用：内置配置覆盖 Python / TypeScript / Rust / Go / Java / C/C++ / Ruby / PHP / Bash / Vue / Svelte / Terraform / Haskell / OCaml / Elixir 等
• 跳转到定义 / 引用 / Hover：支持 node_modules / site-packages / .cargo 等库路径
• Code Actions：Workspace edits 支持

🧩 TypeScript 插件（QuickJS 沙箱）

• OXC 编译 + QuickJS VM：插件编译后运行在嵌入式 QuickJS 虚拟机中
• 沙箱隔离：安全，不污染主进程
• 零 node_modules：插件打包在同一二进制内，无需磁盘依赖

🎨 主题与定制

• 内置主题：High-contrast / Gruvbox / Dracula / Nord / Solarized / Tokyo Night 等
• 实时主题编辑器：「Inspect Theme at Cursor」光标处实时预览
• 状态栏可配置：通过可视化面板选择元素（{clock}、git branch、LSP status）
• i18n：支持日语、韩语、汉语、越南语

🔌 高级功能

• 热退出 Hot Exit：每次修改后持久化，崩溃或重启后恢复所有缓冲区（包括未命名 scratch buffer）
• 自定义快捷键：Keybinding modes + embedded terminals
• Package scaffolding：fresh --init
• Devcontainer 支持：开发容器集成
• 编码与 Workspace Trust：Encoding / Workspace Trust 设置 UI

快捷键速查

光标与选择

文件与导航

搜索与替换

Git

LSP

通用

配置与初始化

init.ts（启动脚本）

// ~/.config/fresh/init.ts（示例）
import { keymap, init, lsp, git, ui } from "fresh:core";

// 设置主题
ui.theme("dracula");

// 自定义快捷键
keymap.bind("ctrl-s", () => commands.save());

// 启用 LSP
lsp.enable("rust-analyzer");

// 启用 Git gutter
git.enableGutter(true);

// 退出时自动保存所有缓冲区
init({
  autoSave: true,
  hotExit: true,
});

配置文件路径

LSP 配置示例

// .vscode/settings.json 或 fresh LSP 配置
{
  "fresh.lsp.pylsp": {
    "plugins": {
      "pylsp_mypy": { "enabled": true },
      "pylsp_rope": { "enabled": false }
    }
  }
}

场景 Recipes

场景 1：日常代码编辑

# 启动 fresh
fresh

# 打开项目
Ctrl+P → 输入文件名

# 多光标批量修改变量名
Ctrl+D 选中每个出现位置 → 重命名 → Enter

# LSP 跳转到定义
F12

# 保存
Ctrl+S

场景 2：Git Code Review

# 用 fresh 替代 git difftool
fresh --wait  # 配合 git rebase -i

# 在 fresh 内打开 Git Review
Ctrl+Shift+G

# 在 diff 面板中：
#   Stage hunk: s
#   Unstage hunk: u
#   Discard: d
#   添加行注释: Ctrl+Enter
#   导出 Review 为 Markdown: Ctrl+E

场景 3：SSH 远程服务器编辑

# 编辑远程文件（如 prod 服务器配置）
fresh deploy@prod:/etc/nginx/nginx.conf

# Ctrl+P 打开远程文件搜索
# 修改后 Ctrl+S 保存（只传 diff）

# 编辑大文件（如日志）
fresh prod-server:/var/log/nginx/access.log
# 即使文件几个 GB，编辑小段也不卡

场景 4：多语言 LSP 开发

# 打开 Rust + TypeScript 混合项目
fresh .

# Fresh 自动检测：
#   Cargo.toml → Rust LSP (rust-analyzer)
#   package.json → TypeScript LSP (tsserver)
#   pyproject.toml → Python LSP (pylsp)

# 跨语言跳转：F12 自动路由到正确的 LSP

坑点与排障

坑 1：Nerd Font 不显示图标

# 终端使用 Nerd Font（如 JetBrains Mono Nerd Font）
# macOS: brew install font-jetbrains-mono-nerd-font
# Linux: 下载 Nerd Font 后 fc-cache -fv

坑 2：SSH 连接断线后文件未保存

# 开启 Hot Exit（默认已开启）
# 用 daemon 模式保持持久连接
fresh -a myproject

# 文件修改后 Ctrl+S 会立即持久化到磁盘

坑 3：LSP 跳转不到库代码

{
  "fresh.lsp.gotoLibraryPath": true,
  "fresh.lsp.libraryPaths": ["node_modules", ".cargo", "site-packages"]
}

坑 4：Windows 远程编辑中文文件名乱码

坑 5：插件 TypeScript 版本冲突

参考链接