# vscode-plugin-rsync-deployment

**Repository Path**: harthali/vscode-plugin-rsync-deployment

## Basic Information

- **Project Name**: vscode-plugin-rsync-deployment
- **Description**: 一个功能强大的VSCode插件，提供类似PHPStorm上传工具的文件同步功能，支持rsync协议进行高效的文件传输和同步。
复刻IntelliJ IDE的deployment工具，为ide转向vscode的脚本开发者提供文件同步功能，支持windows，mac，linux
- **Primary Language**: NodeJS
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-15
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VSCode Rsync部署插件

一个功能强大的VSCode插件，提供类似PHPStorm上传工具的文件同步功能，支持rsync协议进行高效的文件传输和同步。
复刻IntelliJ IDE的deployment工具，为ide转向vscode的脚本开发者提供文件同步功能，支持windows，mac，linux
## 功能特性

- 🚀 支持rsync协议进行文件同步
- 📁 文件修改后自动上传到远程服务器
- 🔄 支持手动上传文件或文件夹
- ⬇️ 支持从远程服务器下载文件到本地
- 🌐 可以浏览远程服务器文件结构
- ⚙️ 支持配置rsync同步的排除文件规则
- 📂 可配置本地项目路径和远程服务器项目路径
- 🎛️ 提供用户友好的配置界面和操作界面

## 安装

1. 在VSCode扩展市场搜索"Rsync Deployment"
2. 点击安装
3. 重启VSCode

## 使用方法

1. 打开命令面板 (Ctrl+Shift+P)
2. 输入"Rsync Deployment: 配置Rsync部署"
3. 配置服务器连接信息和同步规则
4. 开始使用文件同步功能
5. 编译环境要求
   - Node.js 20.x 或更高版本
   - npm 10.x 或更高版本

## 开发

```bash
# 安装依赖
npm install

# 编译
npm run compile

# 监听模式编译
npm run watch

# 打包扩展
npm run package

# 发布扩展(微软)
npm run publish

# 发布扩展(open-vsx)
npm run publish-ovsx
```

## 作者

- **vscode-plugin-rsync-deployment** - [Gitee](https://gitee.com/harthali/vscode-plugin-rsync-deployment)
- **lihengtt** - [GitHub](https://github.com/lihengtt)
- **邮箱**: lihengsir@gmail.com

## 贡献

欢迎提交问题、建议和Pull Request来改进这个插件。
- **vscode-plugin-rsync-deployment** - [Gitee](https://gitee.com/harthali/vscode-plugin-rsync-deployment)
## 版本更新历史

### v0.0.8 (2024-12-20)

**重要修复和优化**

- 🐛 **修复Windows系统远程路径错误**: 解决了编辑器初始化时`remotePath`错误变成`remotePath + localPath`的问题
- 🔧 **修复自动同步按钮状态更新**: 确保`toggleAutoSync`后webview能正确接收和处理状态更新消息
- 🎯 **优化配置对话框用户体验**: 改进了配置流程，避免切换页面导致弹窗关闭的问题
- ⚡ **增强webview状态同步机制**: 确保按钮状态变化能立即反映在界面上
- 🛡️ **修复扩展打包安全问题**: 删除了不安全的`nul`文件，解决扩展打包时的安全警告

**技术改进**
- 修复了`sftpManager.ts`中的路径拼接逻辑
- 优化了`webviewProvider.ts`中的状态同步机制
- 改进了`configManager.ts`中的配置对话框体验
- 增强了Windows系统的兼容性和稳定性

### v0.0.5 (2024-12-18)

**重大优化和修复**

- 🐛 **修复EBADF错误**: 解决了启用文件自动同步时出现的`Error: spawn EBADF`错误
- 🔧 **修复自动同步按钮无响应**: 完善了webview与后端的消息传递机制
- ⚡ **FileWatcher性能优化**: 
  - 添加文件监控数量限制（最大5000个文件）
  - 添加目录深度限制（最大5层）
  - 实现防抖机制，减少频繁文件变化处理
  - 优化内存使用和资源管理
- 🎯 **智能降级机制**: 大项目自动切换为手动同步模式，避免系统资源耗尽
- 📋 **增强排除规则**: 默认排除更多不必要的文件类型和目录
- 🔍 **系统诊断工具**: 新增诊断命令，帮助排查进程冲突和资源占用问题
- 🛠️ **进程管理优化**: 改进spawn进程配置，增强错误处理和资源清理
- 📊 **性能监控**: 添加内存使用监控和智能资源管理

**技术改进**
- 优化了文件监控的启动和停止逻辑
- 增强了错误日志记录和用户反馈机制
- 改进了webview界面的响应性和稳定性
- 完善了插件停用时的资源清理

## 许可证

MIT License