localsend配置异常时可恢复默认设置:一、删除用户数据目录后重启;二、用--no-config参数跳过配置加载;三、手动替换config.json为默认json;四、windows需清理注册表自启项。

如果您在使用LocalSend过程中修改了大量设置,导致界面异常、传输失败或行为偏离预期,则可能是配置文件已被覆盖或损坏。以下是恢复LocalSend默认设置的多种可行方法:
一、重启应用并清除用户配置目录
LocalSend的全部用户级配置(包括设备名称、保存路径、端口、托盘设置等)均存储于系统特定的用户数据目录中。删除该目录将强制应用在下次启动时重建默认配置。
1、关闭LocalSend所有运行实例,包括系统托盘进程。
2、根据操作系统定位并删除LocalSend用户数据目录:
Windows:删除 %APPDATA%\LocalSend\
macOS:删除 $HOME/Library/Application Support/LocalSend/
Linux:删除 $HOME/.config/LocalSend/
3、重新启动LocalSend,此时所有设置将回归出厂状态,设备名称为“LocalSend-XXXX”,保存路径为系统默认下载目录,端口为3000。
二、使用命令行参数跳过加载现有配置
LocalSend支持通过启动参数临时绕过用户配置读取,直接以默认参数初始化运行。该方式不修改磁盘文件,适合快速验证是否为配置问题所致。
1、打开终端(Windows:命令提示符或PowerShell;macOS/Linux:Terminal)。
2、输入以下命令启动LocalSend(请替换为您的实际可执行文件路径):
Windows示例: localsend_app.exe --hidden --no-config
macOS/Linux示例: ./localsend --hidden --no-config
3、观察主界面是否显示默认设备名与初始设置项。若确认正常,可配合方法一永久重置。
三、手动重置配置文件内容
LocalSend的主配置文件为JSON格式,位于用户数据目录内(如 config.json 或 settings.json)。直接编辑该文件可精准还原关键字段,避免全目录删除带来的历史记录丢失风险。
1、关闭LocalSend后,进入对应平台的用户数据目录(参考方法一中的路径)。
2、找到名为 config.json 的文件,用文本编辑器打开。
3、将其内容完全替换为以下最小化默认配置:
{"deviceName":"LocalSend-XXXX","savePath":"","port":3000,"autoStart":false,"minimizeToTray":true,"quickSave":false,"serverIp":"0.0.0.0"}
4、保存文件,重启LocalSend。注意:设备名中的“XXXX”将在启动时由程序自动生成随机后缀。
四、通过注册表或系统登录项清理残留启动配置(仅Windows)
若LocalSend被设为开机自启,且此前通过注册表方式配置,残留的错误路径或参数可能导致启动异常,进而影响配置加载逻辑。需同步清理注册表项以确保干净重启。
1、按下 Win + R,输入 regedit 并回车。
2、导航至:HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run
3、在右侧列表中查找名称为 LocalSend 的字符串值。
4、右键该条目 → 选择“删除”。
5、重启电脑后,再执行方法一或方法三进行配置重置。











