Frequently asked questions - 常见问题

[1111mp]

This document refers to the FAQ document of clash-verge-rev. This project is also developed using the tauri framework, so most of the problems encountered during installation and use are the same. nvm-desktop also learned a lot from this project during the process of refactoring using the tauri framework. Many thanks to the author and maintainer of the project for their open source 🌹

Windows

VCRUNTIMEXXX.dll not found, code execution cannot continue

• Reason: The operating system lacks the libraries required by the VC runtime environment.

• Solution: Download and install the VC runtime library.

  Arch	Lib	Download
  x64	vc_redist.x64.exe	vc_redist.x64.exe
  x86	vc_redist.x86.exe	vc_redist.x86.exe
  arm64	vc_redist.arm64.exe	vc_redist.arm64.exe

This app can't run on your computer

• Reason: 99.99% of the time it's because you downloaded the wrong file. Please check if you downloaded the installation package corresponding to your machine architecture.
• Solution: Download the correct installation package.

Unable to start/no interface displayed/crash/only tray icon

• Reason: The Tauri framework depends on WebView2. If WebView2 is uninstalled or disabled, the interface will not be displayed. Specifically, the program can be started, but clicking the tray menu does not respond.
• Solution:
  • If you disabled Edge using third-party software, please check whether WebView2 is disabled at the same time and undisable WebView2.
  • If you have uninstalled WebView2, you can download the WebView2 installation package and reinstall WebView2.
  • If WebView2 cannot be installed on Enterprise Edition or Win7, please try to download the version with built-in WebView2 (the installation package with fixed_webview2) from Release.
  • If the problem persists, try booting in Windows 7 compatibility mode.

WebView2 cannot be installed normally

• Reason: Maybe your Windows system has turned off automatic updates.
• Solution:
  • Turn on automatic updates
  • If you really can't install WebView2, you can try to download the version with built-in WebView2 from Release (the installation package with fixed_webview2).

MacOS

"File/App is damaged and cannot be opened. You should move it to Trash."

• Reason: Since the app is not signed, it may show that the developer cannot be verified or the app is damaged, and the developer needs to be granted Apple Developer Program membership.
• Solution: Click the Cancel button, then go to the System Preferences -> Security & Privacy page, click the Open Anyway button, and then click the Open button in the pop-up window. If your system version is higher, you may not find the above options in the Security & Privacy page, or it may prompt that the file is damaged when you start it. Open the terminal and execute the following command to authorize.

   sudo xattr -d com.apple.quarantine /Applications/NVM\ Desktop.app

Apple can’t check app for malicious software

• Solution: See the macOS User Guide for details and select the document corresponding to your Mac version.

zsh: permission denied: nvmd

• Reason: Since nvmd is not signed with a certificate, Apple's security policy does not assign permissions by default.
• Solution: Open the terminal and execute the following command to authorize.

  cd $HOME/.nvmd/bin
  sudo chmod +x nvmd

Linux

Can a non-UI graphical interface be used?

• No. NVM-Desktop is a GUI program based on Webview and requires graphical interface support.

Other issues

"error decoding response body"

• Reason: 99.99% of the time it is caused by network problems (some proxy software can also cause this problem)
• Solution: Go to the Settings page and select or enter the appropriate mirror address according to your region
  

---

此文档参考 clash-verge-rev 的常见问题文档，该项目也是使用 tauri 框架开发的项目，所以在安装使用过程中遇到的问题大多相同。 nvm-desktop 在使用 tauri 框架进行重构的过程中也从该项目中学习到很多，非常感谢该项目的作者和维护者的开源 🌹

Windows

找不到 VCRUNTIMEXXX.dll，无法继续执行代码

• 问题原因：操作系统缺少 VC 运行环境所需的库

• 解决方案：下载并安装 VC 运行库

  架构	运行库	下载地址
  x64	vc_redist.x64.exe	vc_redist.x64.exe
  x86	vc_redist.x86.exe	vc_redist.x86.exe
  arm64	vc_redist.arm64.exe	vc_redist.arm64.exe

此应用无法在你的电脑上运行

• 问题原因：99.99% 是因为你下载错了文件，请检查你是否下载了对应你机器架构的安装包
• 解决方案：下载正确的安装包

无法启动/不显示界面/闪退/只有托盘图标

• 问题原因：Tauri 框架依赖于 WebView2。如果卸载或禁用了 WebView2 ,将无法显示界面。具体表现为: 程序可以启动，但是点击托盘菜单没有反应。
• 解决方案：
  • 如果是利用第三方软件禁用了 Edge，请检查是否同时禁用了 WebView2，将 WebView2 取消禁用。
  • 如果是卸载了 WebView2，可以下载 WebView2 安装包，重新安装 WebView2。
  • 如果是企业版系统或 Win7 无法安装 WebView2，请尝试在 Release 下载内置了 WebView2 的版本（带有 fixed_webview2 字样的安装包）。
  • 若问题仍然存在，请尝试使用 Windows 7 兼容模式启动。

WebView2 无法正常安装

• 问题原因：可能是你的 Windows 系统关闭了自动更新
• 解决方案：
  • 打开自动更新
  • 若实在无法安装 WebView2，可以尝试在 Release 下载内置了 WebView2 的版本（带有 fixed_webview2 字样的安装包）。

MacOS

“文件/应用程序已损坏，无法打开。您应该将其移至废纸篓。”

• 问题原因: 由于应用没有签名，所以可能会显示开发者无法验证或应用已损坏，需要授予开发者Apple Developer Program 会员资格。
• 解决方案: 点击 取消 按钮，然后去 系统偏好设置 -> 安全性与隐私 页面，点击 仍要打开 按钮，然后在弹出窗口里点击 打开 按钮即可。如果你的系统版本较高，可能在 安全性与隐私 页面中找不到以上选项，或启动时提示文件损坏。打开终端，并执行下列命令进行授权。

   sudo xattr -d com.apple.quarantine /Applications/NVM\ Desktop.app

Apple 无法检查 App 是否包含恶意软件

• 解决方案: 详见 macOS 使用手册，并选择对应 mac 版本的文档。

zsh: permission denied: nvmd

• 问题原因：由于 nvmd 没有证书签名，Apple 的安全策略默认不会分配权限。
• 解决方案：打开终端，并执行下列命令进行授权。

  cd $HOME/.nvmd/bin
  sudo chmod +x nvmd

Linux

无 UI 图形化界面能用吗

• 不能。NVM-Desktop 是基于 Webview 的 GUI 程序，需要图形化界面支持。

其他问题

"error decoding response body"

• 问题原因：99.99% 是因为网络问题导致（有的代理软件也会导致这个问题）
• 解决方案：前往 设置 页面，根据自己所在地区选择或输入合适的镜像地址