集成 VS Code 服务器

通过 code-server 在 RoqueOS 内运行的 真实 VS Code（不是 fork，不是克隆）。与您在桌面上使用的相同引擎、来自市场的相同扩展、相同配置 — 可从任何已登录的浏览器访问。

为什么不只是"VS Code Web"

免费 Web 版本（vscode.dev、github.dev）有 严格的限制:

• ❌ 不运行需要服务器 Node.js 的扩展（Python language server、完整 ESLint）
• ❌ 没有"真实"的 Git（仅 GitHub.com 浏览）
• ❌ 没有嵌入式终端
• ❌ 不运行调试器

在 RoqueOS Server 上运行的 code-server 是 完整的 VS Code:

• ✅ 扩展市场可用（任何扩展）
• ✅ 嵌入式终端连接到服务器容器
• ✅ 完整 Git (push、pull、branch、merge、stash)
• ✅ 用于 Node、Python、Go 等的调试器
• ✅ 设备之间的设置同步（因为它在您的服务器上，而不是 MS 的服务器上）
• ✅ dev 服务器的实时预览（自动端口转发）

如何打开

Launchpad → VS Code。第一次需要约 10 秒才能启动 code-server。之后立即打开。

共享文件系统

与 Terminal 和 Finder 中出现的相同 /home/user/:

• 在 Finder 中创建文件 → 出现在 VS Code 的 Explorer 中
• 在 VS Code 中保存代码 → Terminal 中 git status 显示
• 在 Terminal 中 wget → 文件出现在 Explorer 中

推荐扩展

市场可用 — 但某些扩展在初始设置中产生很大的差异:

必备:

• GitLens — git annotations inline、blame、history
• Error Lens — 直接在行上的错误（无需进入 Problems 面板）
• Prettier + ESLint — 格式化 + lint
• Path Intellisense — 导入路径的自动完成

语言（根据您的堆栈安装）:

• Volar — Vue 3
• Tailwind CSS IntelliSense — 类的自动完成
• Python (Microsoft) — 完整的 language server
• Go (Google) — 官方 Go 支持
• rust-analyzer — Rust
• Java Extension Pack (Red Hat)

生产力:

• Todo Tree — 在面板中聚合 // TODO
• Better Comments — // ! // ? // TODO 的颜色编码
• Material Icon Theme — 文件夹/文件图标

Git 工作流程

VS Code 的嵌入式终端连接到相同的 Ubuntu 容器。您可以:

git clone git@github.com:your/repo
cd repo
git checkout -b feature/x
# ... 编码 ...
git add -A && git commit -m "feat: new feature"
git push origin feature/x

SSH 密钥位于 /home/user/.ssh/（持久）。生成一次，在 GitHub 中配置，忘记它。

dev 服务器的实时预览

在嵌入式终端运行 yarn dev → VS Code 检测端口（3000、5173 等）→ 自动提示 "Open in browser?"。点击 → 在 Roque Browser 中打开。

无需使用 ngrok，无需配置端口转发。

原生设置同步

您的首选项（主题、键绑定、已安装的扩展、代码片段）保存在 您的服务器 上的 /home/user/.config/code-server/。在更新之间持久化，在容器重新创建中存活。

不使用 Microsoft 的 Settings Sync（需要 GitHub/Microsoft 账户）— 您是您数据的所有者。

与 Roque Code 的区别

方面	Roque Code	VS Code (code-server)
运行位置	浏览器（Monaco 独立）	服务器的 Ubuntu 容器
设置	对每个用户都有效	需要服务器模式
扩展	❌	✅ 完整市场
Git	❌	✅
终端	❌（使用 Terminal 应用）	✅ 嵌入式
调试器	❌	✅
文件大小	良好至 10MB	没有实际限制
语言 (LSP)	50+ 仅语法	100+ 带完整 IntelliSense

简单规则:

• 编辑 package.json 或小代码片段 → Roque Code（更快）
• 带 Git 的全栈项目 → 集成 VS Code

性能

VS Code 在服务器容器中运行 — UI 通过 WebSocket 来到浏览器。延迟取决于服务器延迟:

• 本地服务器 (LAN): ~5-10ms — 与原生 VS Code 无法区分
• Cloud 服务器 (Hetzner DE): 180-220ms — 打字有轻微延迟（按键和字符显示之间~200ms）

对于服务器距离较远的密集开发，请考虑:

• 您机器上的 本地 RoqueOS Server（零延迟）
• RoqueOS 桌面应用程序（相同延迟，但带 tray + OS 快捷键）

限制

• 本地代码片段 保存在服务器上（需要服务器模式才能有代码片段）。没有服务器模式，没有 VS Code（使用仅浏览器的 Roque Code）。
• 复杂的 GUI 调试器 打开单独窗口（Chromium debug 等）可能无法完全工作 — 通过嵌入式终端的 "headless" 调试更好。
• GPU 加速 在容器内不可用 — 渲染 3D 的扩展不工作。

另请参阅

• Roque Code — 无需服务器模式的仅浏览器编辑器
• Linux 终端 — bash + roqueos-cli 预安装
• Containers Manager — 通过 UI 管理 Docker
• App Store Docker — 安装 Plex、Nextcloud 等