Windows 平台安装 QOwnNotes 完整指南:免安装绿色版、可移植模式与包管理器多方案 桌面应用【免费下载链接】QOwnNotesQOwnNotes 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 上它采用零安装设计只需下载并解压QOwnNotes.zip即可直接运行无需任何安装程序同时它还提供内置的可移植Portable模式并可通过 Chocolatey、Scoop、WinGet、MSYS2 等包管理器一键部署。读完本文你将掌握 Windows 下 QOwnNotes 的全部安装路径、可移植模式的底层数据存储原理以及旧版 Windows 系统下的兼容方案。QOwnNotes 可移植模式设置界面一、绿色免安装下载 ZIP 压缩包直接运行QOwnNotes 在 Windows 上最常见的安装方式就是绿色版免安装前往 QOwnNotes 官方 Releases 页面下载最新的Windows 归档包文件名形如QOwnNotes.zip将压缩包解压到任意位置例如C:\QOwnNotes或 U 盘进入解压后的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.batREM 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 选项其中与本文相关的常用项包括参数说明--portable以可移植模式运行应用--clear-settings清空设置后运行应用--session name使用独立上下文运行应用设置与内部文件分开存放--allow-multiple-instances允许启动多个实例--version打印版本号--help显示帮助信息在 Windows 上直接调用可执行文件时命令形态为QOwnNotes.exe --portable QOwnNotes.exe --session test自动更新器与可移植模式的联动可移植模式下自动更新同样可用且更新脚本会感知模式。查看 src/dialogs/updatedialog.cpp当程序以可移植模式运行时更新器会在启动参数中追加--portableQStringList 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模式下保留可移植数据目录的连续性。四、旧版 WindowsWindows 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 生态中还有多个社区维护的包适合习惯用包管理器管理软件的开发者。Chocolateychoco install qownnotesChocolatey 社区维护着 QOwnNotes 的软件包安装后即可在系统层面管理、升级 QOwnNotes。执行该命令需要管理员权限的 PowerShell 或 CMD 环境Chocolatey 本身的要求。Scoop可移植模式安装scoop bucket add extras scoop update scoop install qownnotesScoop 的 Extras bucket 中包含 QOwnNotes 包且Scoop 安装方式本身就是可移植的——所有程序默认安装到用户目录如%USERPROFILE%\scoop\apps不写注册表、不需要管理员权限与 QOwnNotes 的绿色设计天然契合。安装后即可通过qownnotes命令启动。WinGetwinget install qownnotesWindows 包管理器WinGet同样提供了社区维护的 QOwnNotes 清单manifest适用于 Windows 10 1709 / Windows 11 的现代系统。MSYS2pacman -S mingw-w64-qownnotesMSYS2 环境中提供了mingw-w64-qownnotes包面向在 MSYS2 / MinGW-w64 生态中工作的用户可用 pacman 直接安装。六、安装方式速查与选择建议场景推荐方式命令 / 操作日常使用追求零依赖绿色版 ZIP下载QOwnNotes.zip解压后运行QOwnNotes.exe数据随身携带U 盘等可移植模式双击QOwnNotesPortable.bat系统包管理Chocolateychoco install qownnotes用户级可移植管理Scoopscoop bucket add extras scoop install qownnotes现代 Windows 内置管理WinGetwinget install qownnotesMSYS2 开发环境MSYS2pacman -S mingw-w64-qownnotesWindows XP / 8.1旧版构建26.10.0 的QOwnNotes-Qt5.7-legacy.zip不再更新无论选择哪种方式QOwnNotes 的核心理念始终不变无需安装、配置文件与笔记数据完全可控。通过 appveyor/QOwnNotesPortable.bat、appveyor/update.bat 与 src/main.cpp 的源码配合你可以清晰地理解绿色版 可移植模式 自动更新这套在 Windows 上完整自洽的部署体系。赞分享桌面应用【免费下载链接】QOwnNotesQOwnNotes 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 Windows 安装与便携模式完全指南绿色版解压运行、--portable 原理与包管理器安装QOwnNotes Windows 安装与便携模式完全指南绿色版解压运行、 portable 原理与包管理器安装 本文以 QOwnNotes 官方文档中面向桌面应用Task 安装完全指南从包管理器到源码编译的多平台安装方案Task 安装完全指南从包管理器到源码编译的多平台安装方案 Task 是一个受 Make 启发的现代化跨平台任务运行器构建工具本项目仓库即为其完整源码与构建工具开发工具CLI终极指南Windows包管理器Winget完整安装方案终极指南Windows包管理器Winget完整安装方案 Windows系统终于迎来了官方的包管理器Winget但令人困惑的是这个强大的命令行工具本身却没有提开发工具CLI上一篇猫抓嗅探重新定义浏览器媒体资源获取体验下一篇ChatGPT-4o 2025-05-06 系统提示词全解6 个内置工具与人格设定的完整拆解创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考