VS Code的ftp-simple扩展中[DIR]含义及完整同步问题咨询

1. 检查配置里的目录过滤规则 #

打开VS Code设置，搜索ftp-simple，重点核对两个配置项：

• Ftp-simple: Remote Path：确认路径是否指向正确的FTP根目录，路径错误会直接导致部分子目录无法被识别
• Ftp-simple: Ignore：查看是否误添加了需要同步的子文件夹或文件后缀，比如规则里写了*/temp/*，那temp文件夹就会被跳过，仅显示[DIR]但不加载内容

2. 手动触发目录刷新或重新连接 #

在VS Code左侧文件面板的远程目录区域操作：

• 右键点击显示[DIR]的父文件夹，选择Refresh选项，强制重新拉取目录结构
• 如果刷新无效，右键点击远程根目录选择Reconnect，重新建立FTP连接后再尝试刷新

3. 调整连接超时与并发设置 #

通过命令面板Ftp-simple: Edit Config打开配置文件，添加或修改以下参数：

{
  "host": "你的FTP主机地址",
  "port": 21,
  "timeout": 30000, // 延长超时时间至30秒，避免小文件传输超时中断
  "parallel": 3, // 降低并发数，多数FTP服务器对并发连接有限制
  "passive": true // 务必启用被动模式，防火墙环境下主动模式极易失败
}

4. 检查FTP服务器权限与目录属性 #

联系服务器管理员确认：

• 显示[DIR]的子文件夹是否给FTP用户开放了LIST和READ权限，无权限会导致无法读取目录内容
• 目录是否存在特殊属性，比如Linux下的chattr锁定、Windows下的只读属性，这类属性会阻碍ftp-simple读取目录

5. 切换传输模式 #

在配置中确保passive设为true，若问题仍存在，尝试修改type参数：

"type": "binary"

二进制模式兼容所有文件类型，可避免因文本编码问题导致的传输中断

6. 清除扩展缓存 #

ftp-simple的缓存损坏也会引发显示异常：

• 关闭VS Code，找到缓存目录：Windows路径为%APPDATA%\Code\User\workspaceStorage，Mac路径为~/Library/Application Support/Code/User/workspaceStorage
• 删除与ftp-simple相关的缓存文件夹，重启VS Code后重新连接FTP

内容的提问来源于stack exchange，提问作者Murat Dinç