NppFTP插件必须完整安装NppFTP.dll、libeay32.dll、ssleay32.dll三个同架构DLL文件至plugins目录,缺一或架构不匹配均导致加载失败;SFTP连接须端口22(或服务器实际SSH端口)、禁用本地缓存并手动上传下载,注意编码、权限及路径配置。

装 NppFTP 插件必须带齐三个 DLL 文件
只丢 NppFTP.dll 进 plugins 目录,99% 会失败——Notepad++ 启动时弹出 Failed to load plugin: NppFTP.dll,菜单里根本不见 NppFTP 选项。
- 必须从 GitHub 官方 release 页面(如 v0.27.3)下载完整 zip 包,解压后取出
NppFTP.dll、libeay32.dll、ssleay32.dll三个文件 - 全部复制到
C:\Program Files\Notepad++\plugins(或你安装的实际路径),不能嵌套进子文件夹 - 32 位 Notepad++ 必须配 32 位 DLL,64 位同理;混用会导致插件加载静默失败,右下角状态栏只显示
Plugin loading failed - 装完务必彻底退出所有 Notepad++ 进程(任务管理器查
notepad++.exe和托盘图标),再重新打开
SFTP 连不上?先核对端口和协议名
选了 SFTP 却卡在 Connection refused 或 Authentication failed,基本不是密码错,而是协议/端口不匹配。
-
Connection refused:几乎全是端口填错。SFTP 走 SSH 端口,默认是22,不是 FTP 的21;阿里云/腾讯云常把 SSH 端口改成2222或10022,得去服务器看/etc/ssh/sshd_config里的Port值 -
Authentication failed:密码登录时,用户名必须是系统账号(如ubuntu、root),不是 FTP 虚拟用户;密钥登录时,Private key file必须是无密码的 OpenSSH 格式(.ppk不行,用 PuTTYgen 导出时选Export OpenSSH key) - Host 字段**不能写
sftp://或ftp://**,只填 IP 或域名,否则直接连不上
编辑保存后没更新到服务器?关掉本地缓存
NppFTP 默认把远程文件下载到临时缓存再打开,Ctrl+S 传回去的是那个缓存副本,不是你当前正在改的实时内容——尤其别人也在 vim 里同步改同一文件时,它不做冲突检测,悄悄覆盖。
- 进入
Settings → Preferences → Backup,取消勾选Remember current session for next launch(避免旧连接残留干扰) - 在 NppFTP 面板右键 →
Advanced Settings→ 把Cache files locally改成Never - 每次编辑前,右键目标文件 →
Download拉最新版;改完右键 →Upload,别依赖“自动同步” - 如果服务器上文件权限不足(比如目录无写权限、文件无读权限),也会导致上传失败,报
Permission denied,跟插件无关
双击打不开文件?编码和权限要手动调
连接成功、目录可见,但双击文件空白或乱码,问题不在网络,而在本地解析和服务器权限。
- Linux 文件多为 UTF-8 编码,Notepad++ 默认用 ANSI 打开;右键文件 →
Encoding → Convert to UTF-8再保存 - 提示
Permission denied:用ls -l看文件是否含r(读)、目录是否含w(写);磁盘满也会触发同样错误 -
Initial remote directory在 Advanced 设置里填好(如/var/www/html),能省去每次连接后手动翻目录
最易被忽略的是缓存机制和权限校验——它不报错,只静默传错版本,等上线才发现逻辑崩了。


















