前言

在日常开发中，我们经常需要在本地编写代码，然后将代码同步到远程服务器进行测试或部署。传统的方式是使用 FileZilla、WinSCP 等第三方工具手动上传文件，这种方式不仅繁琐，而且容易出错。VSCode 的 SFTP 插件可以帮助我们实现本地代码与远程服务器的自动同步，大大提高开发效率。

应用场景

SFTP 插件适用于以下场景：

• 本地开发，远程调试：在本地编写代码，保存后自动同步到远程服务器，无需手动上传
• 快速部署：本地测试通过后，一键同步到生产环境服务器
• 多服务器管理：同时管理多个远程服务器，快速切换上传目标
• 团队协作：统一开发环境，确保代码在服务器端运行一致

安装插件

打开 VSCode，按下快捷键 Ctrl + Shift + X 打开扩展商店，搜索 sftp，找到名为 SFTP 的插件（作者：Natizyskunk），这是安装量最高、最受欢迎的 SFTP 插件。点击安装即可。

安装完成后，VSCode 会在侧边栏显示 SFTP 图标，表示插件已成功安装。

配置插件

生成配置文件

插件安装完成后，我们需要为当前项目创建配置文件。有两种方式：

方式一：使用命令面板

1. 按下快捷键 Ctrl + Shift + P 打开命令面板
2. 输入 SFTP: Config 并回车
3. VSCode 会在当前工作区的 .vscode 文件夹下自动生成 sftp.json 配置文件

方式二：右键菜单

1. 在 VSCode 资源管理器中，右键点击项目文件夹
2. 选择 SFTP: Config
3. 同样会生成 sftp.json 配置文件

配置示例

打开生成的 sftp.json 文件

{
    "name": "myserver",
    "host": "192.168.1.5",
    "protocol": "sftp",
    "port": 5533,
    "username": "root",
    "privateKeyPath": "~/.ssh/id_ed25519",
    "remotePath": "/opt/test",
    "uploadOnSave": true,
    "ignore": [
        ".vscode",
        ".git",
        ".kiro",
        ".DS_Store",
        "node_modules",
        "*.log",
        "*.tmp"
    ],
    "syncOption": {
        "delete": true,
        "skipCreate": false,
        "ignoreExisting": false,
        "update": true
    },
    "watcher": {
        "files": "**/*",
        "autoUpload": true,
        "autoDelete": false
    }
}