推荐使用Snap一键安装：sudo snap install notepadqq，自动部署最新稳定版及全部依赖；若不可用，则APT方式需确认源版本（SP1默认支持3.4.0+，SP0需先添加PPA）；离线安装deb包后必须执行sudo apt --fix-broken install修复依赖。
在麒麟V10系统上安装Notepadqq，需避开软件商店中可能存在的旧版或缺失依赖问题，直接采用终端命令方式确保版本最新、依赖完整、启动稳定。
通过Snap一键安装（推荐）
打开终端，执行以下命令：
sudo snap install notepadqq
该命令会自动拉取最新稳定版并完成全部依赖部署。Snap包已通过麒麟V10 SP1+内核兼容性验证，无需手动配置Qt环境或编译工具链。安装完成后，应用图标将出现在【开始菜单】→【编程】分类中，首次启动时自动创建用户配置目录 ~/.config/notepadqq/。
使用APT从官方源安装
若系统未启用Snap或受限于企业策略，可改用APT方式：
sudo apt update && sudo apt install notepadqq -y
注意：此方法依赖系统软件源是否已同步最新仓库。银河麒麟V10 SP1默认源已收录notepadqq 3.4.0+版本；SP0用户需先执行 sudo apt-add-repository ppa:notepadqq-team/notepadqq 更新源列表，否则将安装2.9.x旧版，存在UTF-8中文路径崩溃风险。
手动安装Deb包（离线/定制环境）
方法一：下载官方预编译deb包
访问 Notepadqq GitHub镜像发布页 https://gitcode.com/gh_mirrors/no/notepadqq/releases ，下载适用于Ubuntu/Debian的 .deb 包（如 notepadqq_3.5.0_amd64.deb 或 notepadqq_3.5.0_arm64.deb）。
方法二：终端安装并修复依赖
第一步：进入下载目录，执行 sudo dpkg -i notepadqq_*.deb
第二步：若提示 dependency problems，【必须立即执行】 sudo apt --fix-broken install -y ——该命令会补全 libqt5webengine5、libxss1 等关键运行时库，跳过此步将导致启动后白屏或闪退。
第三步：安装完成后，在终端输入 notepadqq 即可启动，无需重启桌面环境。
