QOwnNotes 在 Windows 上的完整安装指南：免安装 ZIP、便携模式与包管理器全解析-育师

桌面应用

【免费下载链接】QOwnNotes

QOwnNotes is a plain-text file notepad and todo-list manager with Markdown support and Nextcloud / ownCloud integration.

项目地址：https://gitcode.com/gh_mirrors/qo/QOwnNotes

点击查看免费下载

QOwnNotes 是一款纯文本 Markdown 笔记与待办事项管理工具，支持与 Nextcloud / ownCloud 深度集成。在 Windows 上它采用"绿色免安装"设计——官方发行物是一个 ZIP 压缩包，解压即用，无需执行任何安装程序；同时它还提供了把全部数据（含笔记）收纳进程序目录的便携模式。本文将基于官方 Windows 安装文档，完整覆盖 ZIP 免安装部署、便携模式、旧版 Windows 兼容说明以及 Chocolatey / Scoop / WinGet / MSYS2 四种包管理器安装方式，并结合仓库源码剖析便携模式与自动更新机制的底层实现，帮助你按需选择最合适的部署方案。

一、官方推荐方式：下载 ZIP 压缩包，解压即用

QOwnNotes 在 Windows 上的官方推荐安装方式是便携式 ZIP 分发，整个过程不涉及任何安装向导。

前往官方 Release 页面下载最新的Windows 压缩包（英文文档中即QOwnNotes.zip文件），韩文安装文档亦明确提示认准名为QOwnNotes.zip的文件；
将该 ZIP 解压到任意你希望存放的目录；
进入解压出的QOwnNotes文件夹，直接双击运行QOwnNotes.exe即可启动，无需安装。

这是该项目在所有 Windows 部署路径中最基础、也是文档最先推荐的一条路径，适合绝大多数普通用户。

自动更新程序对目录写权限的要求

::: warning 重要警告如果你希望使用 QOwnNotes 内置的自动更新程序，请务必把 ZIP 解压到当前用户账户拥有写权限的位置。默认情况下，用户账户对C:\Program Files (x86)或C:\Program Files这类系统目录没有写权限，自动更新将无法覆盖旧文件而失败。 :::

这条限制的根源在于自动更新需要在程序目录内替换QOwnNotes.exe及配套文件。仓库中的 Windows 更新脚本 appveyor/update.bat 清晰展示了这一过程：脚本先用taskkill /IM QOwnNotes.exe结束运行中的进程，再调用unzip.exe -o <source> -d <destination>把新压缩包覆盖解压到目标目录，随后清理临时文件并重新启动程序。整个过程都在程序所在目录内写入文件，因此该目录必须对当前用户可写。

二、便携模式：让一切数据都留在 QOwnNotes 文件夹内

如果你希望笔记、配置、缓存等所有数据都不散落在系统用户目录中，可以使用便携模式。

如何启动

在解压后的QOwnNotes文件夹中找到QOwnNotesPortable.bat并运行它，即可让 QOwnNotes 以便携模式启动。在该模式下，所有内容（包括你的笔记）只会被存储在你的QOwnNotes文件夹中——这意味着你可以把整个文件夹放进 U 盘、移动硬盘随身携带，换一台机器解压即可继续使用。

这个批处理文件的内容非常简单，仓库源码 appveyor/QOwnNotesPortable.bat 仅有两行：

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

即：以--portable命令行参数启动QOwnNotes.exe。

便携模式的源码级原理

--portable是 QOwnNotes 的一个正式命令行选项，在 src/main.cpp 中被定义为"Runs the application in portable mode"，并在参数解析循环中（src/main.cpp）被识别并置位。

结合 src/main.cpp 与 src/utils/misc.cpp 的实现，可以梳理出便携模式的四条关键行为：

数据目录重定向：便携模式下，应用的数据根目录被设置为portableDataPath()——即程序所在目录下的Data子目录（例如QOwnNotes\Data），该目录不存在时会被自动创建。配置、数据库、缓存等内部文件全部收拢到这里。
设置格式与路径切换：便携模式下QSettings::setDefaultFormat(QSettings::IniFormat)被启用，并把UserScope的设置路径指到上述Data目录，因此QOwnNotes.ini等设置文件也会落在程序目录内而非%APPDATA%。
笔记路径前置：Utils::Misc::prependPortableDataPathIfNeeded()（src/utils/misc.cpp）会在便携模式生效时，为笔记路径自动拼接便携数据根目录前缀，确保笔记默认也被收纳进程序目录。
禁用 QML 磁盘缓存：由于 QML 缓存路径无法单独配置，便携模式会通过QML_DISABLE_DISK_CACHE=true关闭磁盘缓存（src/main.cpp）。

此外，src/mainwindow.cpp 会在窗口标题中追加 "Portable" 字样，方便你确认当前确实运行在便携模式下。设置对话框中也存在专门的便携模式信息页（见 src/dialogs/settingsdialog.ui）。

一个常见误解

::: tip 提示如果你只是没有电脑的管理员权限，并不需要便携模式——因为 QOwnNotes根本不需要安装，普通解压运行即可，无需任何管理权限。便携模式的价值在于"数据随身携带"，而不是"规避权限限制"。 :::

三、旧版 Windows（Windows 8.1 及更早）用户须知

历史版本的官方文档曾针对 Windows 8.1 及更早系统给出专门说明，其中包含两条要点：

Qt 自 5.8 起停止了对 Windows XP 的支持，QOwnNotes 曾在一段时间内改用 Qt 5.7 构建，以便 Windows XP 用户能够继续使用；
Windows 8.1 基于较新的 Windows SDK 构建，普通构建在 8.1 上存在兼容性问题，需要从 CI 构建产物中直接下载 ZIP 解压运行，且该历史构建不支持自动更新机制，新版本需手动下载。

针对当前仓库的现状说明：当前 Windows 正式版构建基于Qt6，最低要求Windows 10；面向 Windows XP 至 Windows 8.1 的 Qt 5.7 旧版（legacy）构建已不再更新，其最终版本号为 QOwnNotes 26.10.0，对应压缩包为QOwnNotes-Qt5.7-legacy.zip（附 SHA-256 校验和文件）。如果你仍在旧系统上使用，应明确以下两点限制：该 legacy 构建只能手动从发布页下载对应版本；其自动更新机制不工作。

四、通过包管理器安装（四种途径）

除免安装 ZIP 外，社区还为 QOwnNotes 维护了多种 Windows 包管理器通道，适合习惯用包管理器统一管理软件的开发者。

Chocolatey

Chocolatey 社区仓库中存在由社区维护的 QOwnNotes 包，以管理员身份打开 PowerShell 或 CMD 后执行：

choco install qownnotes

Scoop

Scoop 的 Extras 桶中维护了 QOwnNotes 包，且该包以便携模式方式安装。依次执行：

scoop bucket add extras scoop update scoop install qownnotes

WinGet

微软的 Windows 包管理器 WinGet 社区清单中也收录了 QOwnNotes（manifest 路径为manifests/p/pbek/QOwnNotes），安装命令为：

winget install qownnotes

MSYS2

对于 MSYS2 环境，社区维护了基于 MinGW-w64 的软件包mingw-w64-qownnotes（packages.msys2.org/base/mingw-w64-qownnotes），在 MSYS2 shell 中执行：

pacman -S mingw-w64-qownnotes

需要说明的是：以上四种均为社区维护的第三方安装通道，与官方 ZIP 发行物相比，包的更新节奏由对应社区决定；若你需要最及时、最可控的版本，仍建议优先采用第一节的官方 ZIP 方式。

五、进阶：便携模式下可配合使用的命令行参数

便携模式只是 QOwnNotes 众多命令行能力之一。在 Windows 上，你可以用QOwnNotes.exe直接携带参数运行（完整的参数说明见仓库文档 webpage/src/getting-started/cli-parameters.md），常用参数包括：

参数	说明
`--portable`	以便携模式运行应用（即`QOwnNotesPortable.bat`内部使用的参数）
`--clear-settings`	清除设置后运行应用
`--session <name>`	以独立上下文运行，用于隔离设置与内部文件，排障时非常有用（如`QOwnNotes.exe --session test`）
`--dump-settings`	以 GitHub Markdown 格式输出应用与环境的设置转储信息后退出，可用于提交问题报告
`--allow-multiple-instances`	即使设置中禁止多实例，也允许启动多个实例
`--action <name>`	启动后触发指定菜单动作（如`QOwnNotes.exe --action actionShow_Todo_List`）

其中--dump-settings在 Windows 上可直接配合clip把诊断信息复制到剪贴板：

QOwnNotes.exe --dump-settings | clip

这些参数在 src/main.cpp 中均有对应的QCommandLineOption定义，属于官方支持、稳定可用的能力。

六、小结与选型建议

综合以上内容，QOwnNotes 在 Windows 上的部署路径可以概括为四类场景：

普通日常使用：下载官方QOwnNotes.zip解压到有写权限的目录（如C:\Users\<用户名>\下任意位置），双击QOwnNotes.exe即可，还能获得自动更新支持；
随身携带 / 多机漫游：使用QOwnNotesPortable.bat进入便携模式，所有数据（含笔记）集中在QOwnNotes文件夹内；
包管理器用户：按需选择 Chocolatey、Scoop、WinGet 或 MSYS2，其中 Scoop 安装的即是便携模式版本；
旧版 Windows 用户：仅限 Windows XP 至 8.1 时可选用已停止更新的 Qt 5.7 legacy 最终版，注意其无自动更新能力。

无论选择哪条路径，QOwnNotes 都保持了"免安装、解压即用"的核心设计——这与仓库中QOwnNotes.exe --portable的参数解析、Data数据目录重定向等源码实现一脉相承，也是它在受限环境中依然可用的关键。