【QOwnNotes】安装笔记

一、Windows 直接安装方式

1.官方安装包

下载地址：https://www.qownnotes.org/installation

安装步骤：

1. 访问官网下载页面
2. 选择 Windows 安装包（通常是.exe或.msi格式）
3. 双击运行安装程序
4. 按照向导完成安装
5. 在开始菜单或桌面找到快捷方式启动

2.使用包管理器安装

Chocolatey（管理员权限运行）：

# 安装 Chocolatey（如果未安装） Set-ExecutionPolicy Bypass -Scope Process -Force [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072 iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')) # 安装 QOwnNotes choco install qownnotes

Scoop：

# 安装 Scoop（如果未安装） irm get.scoop.sh | iex # 安装 QOwnNotes scoop bucket add extras scoop install qownnotes

WinGet（Windows 11/10）：

# 搜索 QOwnNotes winget search qownnotes # 安装 QOwnNotes winget install QOwnNotes.QOwnNotes

3.便携版（Portable）

1. 下载便携版 ZIP 文件
2. 解压到任意目录（如D:\Apps\QOwnNotes）
3. 运行QOwnNotes.exe
4. 笔记数据保存在同目录或自定义位置

Windows 安装特点：

• ✅ 安装简单，一键完成
• ✅ 自动创建开始菜单和桌面快捷方式
• ✅ 自动注册文件关联（.md, .markdown）
• ✅ 包含所有依赖，无需额外配置
• ✅ 支持自动更新

二、MSYS2 安装方式

1.MSYS2 环境准备

安装 MSYS2：

1. 下载 MSYS2：https://www.msys2.org/
2. 运行安装程序，默认安装到C:\msys64
3. 启动 MSYS2 UCRT64 终端

更新系统（首次或定期）：

# 更新包数据库和核心系统pacman -Syu# 关闭终端，重新打开后再次更新pacman -Su

2.搜索 QOwnNotes 包

# 搜索所有架构的 QOwnNotespacman -Ss qownnotes# 典型输出：# ucrt64/mingw-w64-ucrt-x86_64-qownnotes 版本号# mingw64/mingw-w64-x86_64-qownnotes 版本号# clang64/mingw-w64-clang-x86_64-qownnotes 版本号

3.选择合适版本安装

根据你的 MSYS2 环境选择：

安装示例（UCRT64 环境）：

# 安装 QOwnNotes 及其依赖pacman -S mingw-w64-ucrt-x86_64-qownnotes# 或简写（如果唯一匹配）pacman -S qownnotes

4.安装过程解析

安装时会自动处理依赖：

• Qt6 相关库（websockets, 5compat）
• 拼写检查库（aspell）
• 加密库（libbotan）

5.启动方式

MSYS2 终端内启动：

# 直接启动qownnotes# 或使用完整路径/mingw64/bin/qownnotes.exe

Windows 环境启动：

1. 开始菜单：MSYS2 文件夹下找到 QOwnNotes
2. 桌面快捷方式：可能需要手动创建
3. 创建快捷方式命令：

# 查找 .desktop 文件find/mingw64 -name"*.desktop"|grep-i qown# 通常位置：/mingw64/share/applications/qownnotes.desktop

创建 Windows 快捷方式：

1. 找到可执行文件：C:\msys64\mingw64\bin\qownnotes.exe
2. 右键 → 发送到 → 桌面快捷方式

6.语言包安装（可选）

# 搜索语言包pacman -Ss qownnotes|grep-i lang# 安装中文语言包（如果可用）pacman -S mingw-w64-ucrt-x86_64-qownnotes-zh_cn

7.更新和卸载

更新：

# 更新所有包（包括 QOwnNotes）pacman -Syu# 只更新 QOwnNotespacman -S mingw-w64-ucrt-x86_64-qownnotes

卸载：

# 卸载 QOwnNotes（保留配置）pacman -R mingw-w64-ucrt-x86_64-qownnotes# 完全卸载（包括配置）pacman -Rns mingw-w64-ucrt-x86_64-qownnotes

MSYS2 安装特点：

• ✅ 与开发环境集成
• ✅ 使用包管理器管理依赖
• ✅ 便于脚本自动化安装
• ✅ 可以安装多个架构版本
• ❌ 启动方式相对复杂
• ❌ 可能需要手动创建快捷方式

三、配置与优化

首次运行配置：

1. 选择笔记文件夹：

   • 建议使用固定路径（如D:\Notes）
   • 或 MSYS2 家目录（~/Notes）

2. 主题设置：

   • 设置 → 界面 → 选择主题（深色/浅色）

3. 同步配置（可选）：

   • 设置 → 同步 → 配置 Nextcloud/ownCloud

常用插件：

1. 拼写检查：安装对应语言的 aspell 词典

   pacman -Ss aspell-dict pacman -S mingw-w64-ucrt-x86_64-aspell-en

2. 脚本支持：

   • 内置 JavaScript 脚本引擎
   • 支持 Python 脚本（需安装 Python）

问题排查：

启动失败：

# 检查依赖ldd /mingw64/bin/qownnotes.exe|grep"not found"# 重新安装依赖pacman -Syu pacman -S mingw-w64-ucrt-x86_64-qt6-base

中文显示问题：

# 安装中文字体pacman -S mingw-w64-ucrt-x86_64-noto-fonts-cjk# 设置环境变量（可添加到 ~/.bashrc）exportLANG=zh_CN.UTF-8

文件关联：

# 手动关联 .md 文件assoc .md=Markdown ftypeMarkdown="C:\msys64\mingw64\bin\qownnotes.exe""%1"

四、两种方式对比

五、推荐选择

选择 Windows 直接安装如果：

• 只是想用笔记软件，不需要开发环境
• 希望最简单的安装体验
• 需要自动更新提醒
• 不熟悉命令行操作

选择 MSYS2 安装如果：

• 已经使用 MSYS2 作为开发环境
• 喜欢用包管理器统一管理软件
• 需要与终端工具集成使用
• 可能需要多个架构版本

六、最佳实践

1. 数据备份：定期备份~/.config/QOwnNotes/或%APPDATA%\QOwnNotes\
2. 云同步：设置 Nextcloud/ownCloud 同步防止数据丢失
3. 版本控制：笔记文件夹可以配合 Git 进行版本管理
4. 移动端配合：安装 QOwnNotes API 配合移动端应用

七、参考资料

• 官方文档：https://www.qownnotes.org/
• MSYS2 文档：https://www.msys2.org/docs/
• GitHub：https://github.com/pbek/QOwnNotes

安装建议：普通用户建议使用 Windows 直接安装，开发者建议使用 MSYS2 安装以保持环境一致性。