远程开发 #
远程开发概览 #
VSCode 提供了强大的远程开发功能,可以在远程服务器、容器或 WSL 中进行开发。
text
┌─────────────────────────────────────────────────────────────┐
│ 远程开发类型 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ SSH 远程 │ │ 容器开发 │ │ WSL 开发 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ Codespaces │ │ Tunnels │ │
│ └─────────────┘ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
Remote - SSH #
安装扩展 #
text
1. 打开扩展面板(⌘⇧X / Ctrl+Shift+X)
2. 搜索 "Remote - SSH"
3. 安装 "Remote - SSH" 扩展
连接远程服务器 #
text
1. 按 ⌘⇧P / Ctrl+Shift+P
2. 输入 "Remote-SSH: Connect to Host"
3. 输入 SSH 连接信息
格式:user@hostname
4. 选择配置文件
5. 输入密码
SSH 配置文件 #
创建 ~/.ssh/config 文件:
text
Host myserver
HostName example.com
User username
Port 22
IdentityFile ~/.ssh/id_rsa
使用 SSH 密钥 #
bash
# 生成 SSH 密钥
ssh-keygen -t rsa -b 4096
# 复制公钥到服务器
ssh-copy-id user@hostname
# 无密码登录
ssh user@hostname
Remote - Containers #
安装扩展 #
text
1. 打开扩展面板
2. 搜索 "Remote - Containers"
3. 安装 "Dev Containers" 扩展
开发容器配置 #
创建 .devcontainer/devcontainer.json:
json
{
"name": "My Dev Container",
"image": "mcr.microsoft.com/devcontainers/base:ubuntu",
"features": {
"ghcr.io/devcontainers/features/node:1": {}
},
"extensions": [
"dbaeumer.vscode-eslint"
]
}
在容器中打开 #
text
1. 按 ⌘⇧P / Ctrl+Shift+P
2. 输入 "Dev Containers: Reopen in Container"
3. VSCode 构建容器并打开
Docker Compose 配置 #
创建 .devcontainer/docker-compose.yml:
yaml
version: '3'
services:
app:
build: .
volumes:
- ..:/workspace:cached
command: sleep infinity
Remote - WSL #
安装 WSL #
powershell
# 在 PowerShell 中运行
wsl --install
安装扩展 #
text
1. 打开扩展面板
2. 搜索 "WSL"
3. 安装 "WSL" 扩展
在 WSL 中打开 #
text
1. 按 ⌘⇧P / Ctrl+Shift+P
2. 输入 "WSL: Reopen Folder in WSL"
3. 选择 WSL 发行版
WSL 命令 #
bash
# 在 WSL 中打开 VSCode
code .
# 在特定发行版中打开
code --remote wsl+Ubuntu /path/to/folder
GitHub Codespaces #
创建 Codespace #
text
1. 在 GitHub 仓库页面
2. 点击 "Code" 按钮
3. 选择 "Codespaces" 标签
4. 点击 "Create codespace"
连接 Codespace #
text
1. 在 VSCode 中
2. 点击左侧 "Remote Explorer" 图标
3. 选择 "GitHub Codespaces"
4. 点击要连接的 Codespace
VSCode Tunnels #
创建隧道 #
text
1. 按 ⌘⇧P / Ctrl+Shift+P
2. 输入 "Tunnel: Create Tunnel"
3. 登录 GitHub 账号
4. 输入隧道名称
连接隧道 #
text
1. 在另一台机器打开 VSCode
2. 按 ⌘⇧P / Ctrl+Shift+P
3. 输入 "Tunnel: Connect to Tunnel"
4. 选择要连接的隧道
远程开发技巧 #
端口转发 #
text
自动端口转发:
• 运行开发服务器时自动转发端口
• 在 "端口" 面板查看转发端口
手动端口转发:
1. 打开 "端口" 面板
2. 点击 "添加端口"
3. 输入端口号
远程扩展 #
text
在远程环境中安装扩展:
1. 打开扩展面板
2. 切换到 "SSH: 主机名" 或 "容器" 部分
3. 安装需要的扩展
同步设置 #
text
远程环境使用相同的设置:
• 使用设置同步功能
• 或创建 .vscode/settings.json
远程开发实战案例 #
案例1:SSH 连接服务器 #
text
场景:连接远程开发服务器
步骤:
1. 配置 SSH config 文件
2. 按 ⌘⇧P / Ctrl+Shift+P
3. 选择 "Remote-SSH: Connect to Host"
4. 选择配置的服务器
5. 开始远程开发
案例2:容器化开发 #
text
场景:在容器中开发 Node.js 项目
步骤:
1. 创建 .devcontainer 目录
2. 创建 devcontainer.json
3. 按 ⌘⇧P / Ctrl+Shift+P
4. 选择 "Dev Containers: Reopen in Container"
5. 容器构建完成后开始开发
案例3:WSL 开发 #
text
场景:在 Windows 上使用 WSL 开发
步骤:
1. 安装 WSL
2. 安装 VSCode WSL 扩展
3. 在 WSL 中打开项目
4. 享受 Linux 开发环境
远程开发工作流 #
text
┌─────────────────────────────────────────────────────────────┐
│ 远程开发流程 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 需要远程开发 │
│ │ │
│ ├─────▶ SSH 远程服务器? │
│ │ │ │
│ │ ├─ 是 ─▶ Remote-SSH: Connect to Host │
│ │ │ │
│ │ └─ 否 ─▶ 容器开发? │
│ │ │ │
│ │ ├─ 是 ─▶ Dev Containers │
│ │ │ │
│ │ └─ 否 ─▶ WSL 开发? │
│ │ │ │
│ │ └─ WSL: Reopen │
│ │ │
│ └─────▶ 开始远程开发 │
│ │ │
│ ├─▶ 安装扩展 │
│ ├─▶ 配置端口转发 │
│ └─▶ 同步设置 │
│ │
└─────────────────────────────────────────────────────────────┘
快捷键速查表 #
远程连接 #
| 功能 | 命令面板 |
|---|---|
| SSH 连接 | Remote-SSH: Connect to Host |
| 容器打开 | Dev Containers: Reopen in Container |
| WSL 打开 | WSL: Reopen Folder in WSL |
| 隧道连接 | Tunnel: Connect to Tunnel |
端口转发 #
| 功能 | 说明 |
|---|---|
| 查看端口 | 打开 “端口” 面板 |
| 添加端口 | 点击 “添加端口” 按钮 |
常见问题 #
Q: SSH 连接慢怎么办? #
A: 检查网络连接,使用 SSH 密钥认证,优化 SSH 配置。
Q: 容器构建失败? #
A: 检查 Docker 是否运行,查看构建日志,确保配置正确。
Q: WSL 性能问题? #
A: 将项目放在 WSL 文件系统中,而不是 Windows 文件系统。
练习建议 #
练习1:SSH 远程开发 #
text
1. 配置 SSH config
2. 连接远程服务器
3. 在远程环境中开发
4. 使用端口转发
练习2:容器开发 #
text
1. 创建 devcontainer.json
2. 在容器中打开项目
3. 配置开发环境
4. 运行开发服务器
练习3:WSL 开发 #
text
1. 安装 WSL
2. 在 WSL 中打开项目
3. 配置 Linux 开发环境
4. 运行 Linux 命令
总结 #
恭喜你完成了 VSCode 快捷键大全的学习!现在你已经掌握了:
• 基础编辑操作 • 多光标编辑技巧 • 文件管理和搜索 • 窗口和终端操作 • 代码导航和跳转 • 调试技巧 • Git 版本控制 • 扩展管理 • 自定义快捷键 • 高级技巧 • 远程开发
继续练习这些快捷键,让它们成为你的肌肉记忆,你的开发效率将会大幅提升!
最后更新:2026-04-11