VSCode需通过SFTP扩展（liximomo.sftp）实现远程同步；右键无Upload选项因未打开文件夹工作区、SFTP未启用或缺.sftp.json；配置须含host、port、username、remotePath四字段，且remotePath须为绝对路径；uploadOnSave失效多因路径不匹配、ignore规则拦截或远程目录不存在。
VSCode 本身不支持远程文件同步，必须靠扩展实现；SFTP 扩展（ID：liximomo.sftp）是目前最稳定、配置最清晰的选择，其他同名或旧版扩展容易失效或缺少维护。
为什么右键没有 Upload to SFTP Server？
这不是插件没装好，而是两个基础条件没满足：
- 当前必须打开一个文件夹作为工作区（File → Open Folder），仅打开单个文件不行
-
SFTP扩展已启用，且左下角状态栏能看到SFTP图标；若没有，尝试Ctrl+Shift+P→Developer: Reload Window - 未在工作区根目录下创建
.vscode/sftp.json，VSCode 不会加载任何 SFTP 配置
sftp.json 必须填对的四个关键字段
配置错一个就连接失败，尤其注意路径和协议写法：
-
host：IP 或域名，不能带ssh://或sftp:// -
port：默认是22，改过 SSH 端口的必须显式写对 -
username：Linux 用户名，不是邮箱或别名 -
remotePath：必须以/开头，是远程绝对路径，例如/var/www/myapp，写成./myapp或myapp会报Failure
示例最小可用配置：
{
"name": "Staging",
"host": "192.168.1.50",
"port": 22,
"username": "deploy",
"remotePath": "/var/www/myapp"
}
uploadOnSave 失效的常见原因
设了 "uploadOnSave": true 却不自动上传，通常因为：
- 本地文件路径不在
remotePath对应的本地子目录下——VSCode 只对“映射范围内”的文件生效 - 文件被
ignore规则匹配了，比如写了"**/dist/**"，但你改的是dist/index.html - 远程目标路径不存在，SFTP 不会自动创建父目录，需手动
mkdir -p或用右键先上传空文件夹 - 保存时编辑器处于脏状态（如未格式化、有 lint 错误），某些插件会拦截保存事件
真正麻烦的不是配不通，而是上传后发现文件权限不对、符号链接断开、或 .env 这类敏感文件意外传上去——ignore 规则和 remotePath 的边界意识，比连得上更重要。
