nppftp插件需重启notepad++并检查菜单栏是否出现子项；协议须匹配服务器实际配置（sftp默认端口22，ftp端口21）；注意权限、编码（推荐utf-8无bom）、密钥配置及文件路径准确性。
NppFTP 插件能让你在 Notepad++ 里直接打开、编辑、保存远程服务器上的文件，省去下载→改→上传的三步跳。但配置失败、连不上、改了不生效，几乎是新手必踩的坑——核心问题往往不是插件没装好，而是协议选错、端口填错、或编码/权限没对齐。
怎么确认 NppFTP 插件已正确安装并启用
插件管理器里勾选安装后，必须重启 Notepad++ 才会生效；重启后菜单栏「插件」下应出现 NppFTP 子项，且能点击「Show NppFTP Window」唤出右侧连接面板。
常见卡点：
- 企业网络或杀毒软件拦截插件下载 → 改用SourceForge 手动下载
NppFTP.dll，解压后丢进%ProgramFiles%\Notepad++\plugins目录（注意匹配 x64/x86 版本） - 插件列表里搜不到
NppFTP→ 检查 Notepad++ 是否为 v7.9+（旧版如 v7.5.1 对 TLS/SSH 支持弱，易连 SFTP 失败） - 装完没反应 → 右键任务栏托盘图标，选「重新加载插件」，或彻底关闭所有 Notepad++ 进程再重开
SFTP 和 FTP 协议必须严格按服务端实际开启的来选
绝大多数现代 Linux 服务器只开 SSH（即 SFTP），默认端口 22；而传统 FTP 需单独部署 vsftpd/proftpd，且常被防火墙拦。选错协议是「连接被拒绝」「认证失败」最常见原因。
实操判断方式：
- 用命令行测试：在 Windows 的 PowerShell 里执行
ssh user@host能登录 → 必须选SFTP - 如果服务器明确开了 FTP（比如某些 NAS 或老旧虚拟主机），且端口是
21，才选FTP；同时确认是否启用了被动模式（Passive mode），否则列表为空 -
FTPS（FTP over SSL）极少用，除非你明确看到服务商文档写了支持，否则别乱试
连接时用户名、密码、路径权限不对，会导致“无法列出目录”或“保存失败”
不是所有账号都能读写任意路径。例如 root 用户可能被 SSH 限制登录，普通用户 home 目录外的 /etc/nginx/conf.d/ 默认不可写。
关键检查点：
- 用户名填的是系统账号（如
www-data、deploy），不是 FTP 虚拟账号 - 密码输错或 SSH 密钥登录未配置 →
NppFTP不支持密钥交互式输入，必须提前用ssh-copy-id把公钥塞进服务器的~/.ssh/authorized_keys，并在 Profile 设置里勾选「Use key file」并指定私钥路径（id_rsa） - 连接后左侧文件树为空 → 点右键「Change directory」手动输入绝对路径，比如
/var/www/html，看是否报错「Permission denied」
文件保存后没同步到服务器？先盯住状态栏和编码
Notepad++ 保存时不会弹窗提示“已上传”，只在底部状态栏闪一下「Uploading...」→ 成功后变回「Ready」。若状态栏一直卡在 uploading 或直接跳回 ready 但服务器文件没变，大概率是：
- 编码不一致：服务器文件是
UTF-8 without BOM，你本地存成ANSI或带 BOM 的 UTF-8 → 保存前点菜单「编码」→「转为 UTF-8 无 BOM 格式」 - 文件被其他进程占用（如 nginx 正在读取 conf 文件）→ 保存失败但无提示，需看
NppFTP窗口底部日志（点齿轮→「Log settings」开启详细日志） - 保存动作触发的是本地覆盖而非远程写入 → 确保你编辑的是「NppFTP 窗口中双击打开的文件」，而不是用「文件→打开」从本地磁盘选的同名文件
ssh 进去 cat 一下目标文件，比猜强十倍。
