【QOwnNotes】安装笔记

一、Windows 直接安装方式

1. 官方安装包

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

安装步骤：

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

2. 使用包管理器安装

Chocolatey（管理员权限运行）：

cmd 复制代码

# 安装 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：

cmd 复制代码

# 安装 Scoop（如果未安装）
irm get.scoop.sh | iex

# 安装 QOwnNotes
scoop bucket add extras
scoop install qownnotes

WinGet（Windows 11/10）：

cmd 复制代码

# 搜索 QOwnNotes
winget search qownnotes

# 安装 QOwnNotes
winget install QOwnNotes.QOwnNotes

3. 便携版（Portable）

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

Windows 安装特点：

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

二、MSYS2 安装方式

1. MSYS2 环境准备

安装 MSYS2：

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

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

bash 复制代码

# 更新包数据库和核心系统
pacman -Syu

# 关闭终端，重新打开后再次更新
pacman -Su

2. 搜索 QOwnNotes 包

bash 复制代码

# 搜索所有架构的 QOwnNotes
pacman -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	mingw-w64-ucrt-x86_64-qownnotes	`pacman -S mingw-w64-ucrt-x86_64-qownnotes`
MINGW64	mingw-w64-x86_64-qownnotes	`pacman -S mingw-w64-x86_64-qownnotes`
CLANG64	mingw-w64-clang-x86_64-qownnotes	`pacman -S mingw-w64-clang-x86_64-qownnotes`
CLANGARM64	mingw-w64-clang-aarch64-qownnotes	`pacman -S mingw-w64-clang-aarch64-qownnotes`

安装示例（UCRT64 环境）：

bash 复制代码

# 安装 QOwnNotes 及其依赖
pacman -S mingw-w64-ucrt-x86_64-qownnotes

# 或简写（如果唯一匹配）
pacman -S qownnotes

4. 安装过程解析

安装时会自动处理依赖：

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

5. 启动方式

MSYS2 终端内启动：

bash 复制代码

# 直接启动
qownnotes

# 或使用完整路径
/mingw64/bin/qownnotes.exe

Windows 环境启动：

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

bash 复制代码

# 查找 .desktop 文件
find /mingw64 -name "*.desktop" | grep -i qown

# 通常位置：/mingw64/share/applications/qownnotes.desktop

创建 Windows 快捷方式：

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

6. 语言包安装（可选）

bash 复制代码

# 搜索语言包
pacman -Ss qownnotes | grep -i lang

# 安装中文语言包（如果可用）
pacman -S mingw-w64-ucrt-x86_64-qownnotes-zh_cn

7. 更新和卸载

更新：

bash 复制代码

# 更新所有包（包括 QOwnNotes）
pacman -Syu

# 只更新 QOwnNotes
pacman -S mingw-w64-ucrt-x86_64-qownnotes

卸载：

bash 复制代码

# 卸载 QOwnNotes（保留配置）
pacman -R mingw-w64-ucrt-x86_64-qownnotes

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

MSYS2 安装特点：

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

三、配置与优化

首次运行配置：

选择笔记文件夹：
- 建议使用固定路径（如 D:\Notes）
- 或 MSYS2 家目录（~/Notes）
主题设置：
- 设置 → 界面 → 选择主题（深色/浅色）
同步配置（可选）：
- 设置 → 同步 → 配置 Nextcloud/ownCloud

常用插件：

拼写检查：安装对应语言的 aspell 词典
bash 复制代码
```
pacman -Ss aspell-dict
pacman -S mingw-w64-ucrt-x86_64-aspell-en
```
脚本支持：
- 内置 JavaScript 脚本引擎
- 支持 Python 脚本（需安装 Python）

问题排查：

启动失败：

bash 复制代码

# 检查依赖
ldd /mingw64/bin/qownnotes.exe | grep "not found"

# 重新安装依赖
pacman -Syu
pacman -S mingw-w64-ucrt-x86_64-qt6-base

中文显示问题：

bash 复制代码

# 安装中文字体
pacman -S mingw-w64-ucrt-x86_64-noto-fonts-cjk

# 设置环境变量（可添加到 ~/.bashrc）
export LANG=zh_CN.UTF-8

文件关联：

bash 复制代码

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

四、两种方式对比

特性	Windows 直接安装	MSYS2 安装
安装难度	⭐⭐⭐⭐⭐（非常简单）	⭐⭐⭐（需要命令行）
依赖管理	自动处理	包管理器管理
更新方式	内置更新器或重新下载	`pacman -Syu`
环境集成	独立安装	与开发环境集成
多版本支持	困难	容易（不同架构）
配置文件	`%APPDATA%\QOwnNotes`	`~/.config/QOwnNotes`
适合人群	普通用户	开发者/技术用户

五、推荐选择

选择 Windows 直接安装如果：

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

选择 MSYS2 安装如果：

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

六、最佳实践

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

七、参考资料

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

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