企业官网建设流程全解析

• 桌面应用

QOwnNotes 是一款以纯文本笔记为核心、支持 Markdown 与 Nextcloud / ownCloud 同步的笔记与待办事项管理软件。在 Windows 上它采用"零安装"设计：只需下载并解压QOwnNotes.zip即可直接运行，无需任何安装程序；同时它还提供内置的可移植（Portable）模式，并可通过 Chocolatey、Scoop、WinGet、MSYS2 等包管理器一键部署。读完本文你将掌握 Windows 下 QOwnNotes 的全部安装路径、可移植模式的底层数据存储原理，以及旧版 Windows 系统下的兼容方案。

QOwnNotes 可移植模式设置界面

一、绿色免安装：下载 ZIP 压缩包直接运行

QOwnNotes 在 Windows 上最常见的安装方式就是绿色版（免安装）：

1. 前往 QOwnNotes 官方 Releases 页面，下载最新的Windows 归档包（文件名形如QOwnNotes.zip）；
2. 将压缩包解压到任意位置（例如C:\QOwnNotes或 U 盘）；
3. 进入解压后的QOwnNotes目录，直接双击运行QOwnNotes.exe即可，完全不需要安装程序、不需要注册表写入、不需要管理员权限。

从仓库的打包脚本 build-systems/github/windows/build-zip.ps1 可以看到，发布流程会用Compress-Archive生成QOwnNotes.zip，并同时输出QOwnNotes.zip.sha256与QOwnNotes.zip.sha256sum两个校验文件——下载后可用 SHA-256 校验压缩包完整性，避免传输损坏或被篡改。

自动更新器对写入权限的要求

如果你希望使用自动更新器（应用内自动下载并替换新版本），请务必把压缩包解压到你的用户账户拥有写入权限的目录。

默认情况下，普通用户对C:\Program Files (x86)或C:\Program Files这类系统目录没有写入权限，若把 QOwnNotes 解压到这些位置，自动更新将无法替换文件。建议解压到用户目录或自建的应用目录下。

与源码相关的 Windows 细节

在 src/main.cpp 中，针对 Windows 平台有一段专门处理：

// fixing some troubles in Windows 8.1 #ifdef Q_OS_WIN32 QCoreApplication::addLibraryPath(QStringLiteral("./")); #endif

即 Windows 构建会把当前目录加入 Qt 库搜索路径，确保QOwnNotes.exe解压后即可找到随包分发的 Qt DLL 与插件，这正是"免安装、解压即用"得以成立的关键实现之一。

二、可移植模式（Portable Mode）：一切数据收进 QOwnNotes 文件夹

如果你的目标是把 QOwnNotes 随身携带（例如放在 U 盘或移动硬盘上，在任意电脑打开都能看到相同的笔记与配置），请使用仓库中随发布包一起提供的脚本 appveyor/QOwnNotesPortable.bat：

REM Start QOwnNotes in portable mode Start "" QOwnNotes.exe --portable

双击QOwnNotesPortable.bat后，QOwnNotes 会以--portable参数启动，进入可移植模式。

可移植模式的数据存放规则

根据 webpage/src/blog/2016-09-18-Portable-mode.md 以及 src/dialogs/settingsdialog.cpp 中的模式说明，可移植模式下：

• 内部的SQLite 数据库（notes.sqlite）和设置会存放在可执行文件所在位置的Data文件夹中；
• 设置会以INI 文件（而非注册表）的形式保存；
• 笔记文件夹、脚本路径、外部编辑器路径会自动相对于Data文件夹存储，因此无论你把整个 QOwnNotes 目录移动到哪台电脑、哪个盘符，加载到的笔记文件夹都是正确的。

底层实现位于 src/utils/misc.cpp 的portableDataPath()：程序会取QCoreApplication::applicationDirPath()（即可执行文件所在目录），在其下拼接Data子目录并自动mkdir创建，随后所有设置与数据库都落到这个目录里。

对应地，src/main.cpp 在检测到--portable参数时（参数解析见 src/main.cpp），会做两件事：

if (portable) { QSettings::setDefaultFormat(QSettings::IniFormat); QSettings::setPath(QSettings::IniFormat, QSettings::UserScope, Utils::Misc::portableDataPath(arguments.value(0))); QSettings settings; qDebug() << "settings fileName: " << settings.fileName(); }

即把 QSettings 的默认格式切换为INI 文件，并把设置路径指向Data目录，从而实现"设置不写注册表、随目录迁移"。

此外，可移植模式下还会关闭 QML 磁盘缓存（src/main.cpp 中qputenv("QML_DISABLE_DISK_CACHE", "true")），因为 QML 缓存路径无法配置到Data目录，关闭缓存可避免在只读介质或移动场景下出现异常。

提示：没有管理员权限≠必须用可移植模式

有一点需要澄清：如果你只是因为电脑没有管理员权限，其实根本不需要可移植模式——普通绿色版 QOwnNotes 本身就无需安装、无需管理员权限即可运行。可移植模式的真正价值在于"所有数据（包括笔记）只存放在 QOwnNotes 文件夹内"，适合携带与迁移，而不是用来规避权限问题。

三、命令行--portable参数与其他 CLI 选项

--portable本质上是 QOwnNotes 的命令行参数之一。官方命令行参数文档 webpage/src/getting-started/cli-parameters.md 完整列出了可用的 CLI 选项，其中与本文相关的常用项包括：

在 Windows 上直接调用可执行文件时，命令形态为：

QOwnNotes.exe --portable QOwnNotes.exe --session test

自动更新器与可移植模式的联动

可移植模式下自动更新同样可用，且更新脚本会感知模式。查看 src/dialogs/updatedialog.cpp：当程序以可移植模式运行时，更新器会在启动参数中追加--portable：

QStringList parameters(QStringList() << QDir::toNativeSeparators(filePath) << QDir::toNativeSeparators(QCoreApplication::applicationDirPath()) << QDir::toNativeSeparators(unzipPath)); if (Utils::Misc::isInPortableMode()) { parameters << QStringLiteral("--portable"); }

随后调用 appveyor/update.bat 完成更新：脚本会先taskkill /IM QOwnNotes.exe结束正在运行的进程（可移植模式下进程不会自行退出），再用随包的unzip.exe解压新版本覆盖destination目录，最后以QOwnNotes.exe --after-update重新拉起应用，并在--portable模式下保留可移植数据目录的连续性。

四、旧版 Windows：Windows 8.1 及更早版本

历史背景与原因

对于Windows 8.1 及更早版本（特别是 Windows XP 用户），官方文档给出了专门的说明：

• Qt 从 5.8 版本起放弃了对 Windows XP 的支持，而 QOwnNotes 额外提供基于Qt 5.7的构建，以便 Windows XP 用户仍可继续使用；
• Windows 8.1 与常规构建存在兼容问题，因为常规构建基于更新的 Windows SDK 编译。

仓库源码中也保留了对 Windows 8.1 的兼容处理（src/main.cpp 的addLibraryPath("./")注释即注明 "fixing some troubles in Windows 8.1"），印证了这一历史问题。

获取与运行方式

过去，旧版构建产物需要从AppVeyor CI 的构建工件（Artifacts）页面下载压缩包，解压到目标目录后直接运行其中的QOwnNotes.exe，同样无需安装。

需要注意：AppVeyor 构建的自动更新机制在 Windows XP 上不工作，这类用户必须手动下载新版本并自行替换。

当前仓库中的最新状态

需要指出的是，该方案目前已被"冻结"。从仓库根目录的 CHANGELOG.md 可以看到：

• 面向 Windows XP 至 Windows 8.1 的Qt 5.7 旧版构建已不再在 AppVeyor 上构建；
• 常规 Windows 发布版至少需要 Windows 10；
• 最后一个旧版构建是QOwnNotes 26.10.0，以QOwnNotes-Qt5.7-legacy.zip的形式保留在该版本的发布资产中。

也就是说，如果你仍在使用 Windows XP / 8.1，只能获取到固定版本 26.10.0 的旧版构建，且不再有任何更新；Windows 10 及以上用户则应使用常规的QOwnNotes.zip绿色包。相关背景还可以参考仓库中的 docs/qt5-retirement-recommendation.md。

五、通过包管理器安装

除绿色版外，QOwnNotes 在 Windows 生态中还有多个社区维护的包，适合习惯用包管理器管理软件的开发者。

Chocolatey

choco install qownnotes

Chocolatey 社区维护着 QOwnNotes 的软件包，安装后即可在系统层面管理、升级 QOwnNotes。执行该命令需要管理员权限的 PowerShell 或 CMD 环境（Chocolatey 本身的要求）。

Scoop（可移植模式安装）

scoop bucket add extras scoop update scoop install qownnotes

Scoop 的 Extras bucket 中包含 QOwnNotes 包，且Scoop 安装方式本身就是可移植的——所有程序默认安装到用户目录（如%USERPROFILE%\scoop\apps），不写注册表、不需要管理员权限，与 QOwnNotes 的绿色设计天然契合。安装后即可通过qownnotes命令启动。

WinGet

winget install qownnotes

Windows 包管理器（WinGet）同样提供了社区维护的 QOwnNotes 清单（manifest），适用于 Windows 10 1709+ / Windows 11 的现代系统。

MSYS2

pacman -S mingw-w64-qownnotes

MSYS2 环境中提供了mingw-w64-qownnotes包，面向在 MSYS2 / MinGW-w64 生态中工作的用户，可用 pacman 直接安装。

六、安装方式速查与选择建议

无论选择哪种方式，QOwnNotes 的核心理念始终不变：无需安装、配置文件与笔记数据完全可控。通过 appveyor/QOwnNotesPortable.bat、appveyor/update.bat 与 src/main.cpp 的源码配合，你可以清晰地理解"绿色版 + 可移植模式 + 自动更新"这套在 Windows 上完整自洽的部署体系。

• 桌面应用