MacCalendar：完全免费开源的 macOS 菜单栏日历 App #
MacCalendar 是什么？ #
MacCalendar 是一款完全免费且开源的 macOS 菜单栏日历应用，常驻在菜单栏中，随点随看，并附带桌面小组件。
它不仅提供常规日历功能，还针对中文用户深度优化：内置中国农历、24 节气、大部分公历与农历节日，以及自 2015 年以来的中国法定放假安排。同时，MacCalendar 可以读取系统日历数据，按类型筛选、修改和删除日程，并支持自定义菜单栏显示内容，例如图标、日期、时间或自定义格式。
MacCalendar 界面简洁精致，资源占用极小，完全离线运行、不需要联网，适合经常需要查看农历、节假日与日程安排的 macOS 用户，也适合偏好轻量、无广告、隐私友好工具的办公人群。
MacCalendar 有哪些亮点特色？ #
- 完全免费且开源：项目代码托管于 GitHub，采用开源方式发布，任何人都可以查看源码、提交 Issue 或参与贡献，无需付费即可使用全部核心功能。
- 极致轻量，完全离线：界面简洁精致，轻量化占用资源极小，完全离线不需要联网；安装包（dmg）体积仅约 694.6 KB，属于典型的“小而美”工具。
- 中国农历、24 节气与节日：支持中国农历、24 节气以及大部分公历或农历节日，符合中文用户日常查看日期与节气的习惯。
- 中国法定放假安排：内置自 2015 年以来的中国法定放假安排，帮助用户快速了解调休与节假日信息；数据来源为 NateScarlet/holiday-cn。
- 系统日历集成：可读取系统日历数据，支持按类型筛选显示，并允许在应用内修改和删除日程，与 macOS 自带日历无缝配合。
- 高度个性化配置：支持个性化图标、日历类型、周数等显示设置；菜单栏显示内容也可自定义，支持图标、日期、时间以及自定义格式。
- 菜单栏静默运行 + 快捷操作：运行后静默显示在菜单栏，右键或按快捷键
Command + ,即可打开设置窗口，随时调整偏好设置。 - 支持桌面小组件与快捷跳转：应用包含 MacCalendarWidget 桌面小组件，可添加到桌面查看日期；同时支持输入年/月快捷跳转，快速定位到指定月份。
免费下载 MacCalendar #
以下为官方提供的安装包，点击链接即可下载。
| 文件名 | 描述 | 大小 | 下载 |
|---|---|---|---|
| MacCalendar.dmg | - | 694.6 KB | 夸克网盘 |
提示：MacCalendar 使用 Ad-Hoc 签名，未进行 Apple 开发者签名。首次运行前必须执行
xattr -cr /Applications/MacCalendar.app，否则系统可能提示“应用已损坏”或“无法验证开发者”，桌面小组件也将无法显示。
MacCalendar 如何使用？ #
MacCalendar 的使用方式非常直观，安装完成后主要围绕菜单栏与设置窗口展开：
- 启动应用：安装并首次打开 MacCalendar 后，应用会静默显示在 macOS 菜单栏中，不会占用 Dock 或弹出主窗口。
- 打开设置窗口：在菜单栏图标上右键，或按下快捷键
Command + ,，即可打开设置窗口。 - 配置显示内容：在设置中调整个性化图标、日历类型、周数等显示项；也可以自定义菜单栏显示内容，例如仅显示图标、日期、时间或使用自定义格式。
- 查看农历、节日与放假安排：应用内置中国农历、24 节气、大部分公历/农历节日，以及自 2015 年以来的中国法定放假安排。
- 管理日程：授权读取系统日历数据后，可按类型筛选显示日程，并支持在 MacCalendar 中修改和删除日程。
- 快捷跳转：通过输入年/月快速跳转到指定月份，方便查阅历史或未来日期。
- 添加桌面小组件：首次启动 App 后，打开“系统设置 → 桌面与程序坞 → 小组件”，将 MacCalendar 小组件添加到桌面。
如需更新版本，可在偏好设置中选择“检查更新”。
MacCalendar 的常见问题？ #
首次打开提示“应用已损坏”或“无法验证开发者”怎么办？
这是 Ad-Hoc 签名导致的系统隔离提示。请在终端执行 xattr -cr /Applications/MacCalendar.app 解除系统隔离，然后再打开应用。
执行 xattr 命令后仍然无法打开怎么办？
请前往“系统设置 → 隐私与安全性”，在“安全性”栏中点击“仍要打开”，即可允许运行。
桌面小组件为什么不显示？
桌面小组件无法显示通常也与系统隔离属性有关。请先执行 xattr -cr /Applications/MacCalendar.app，再按“系统设置 → 桌面与程序坞 → 小组件”的路径添加 MacCalendar 小组件。
MacCalendar 需要联网吗？
不需要。根据官方说明，MacCalendar 完全离线运行，不需要联网即可使用农历、节日、放假安排和系统日程等功能。
如何更新 MacCalendar？
可以在偏好设置中点击“检查更新”，也可以通过 Homebrew 方式进行升级。
MacCalendar 是免费的吗？
是的。MacCalendar 完全免费且开源，核心功能不收取任何费用。
MacCalendar 如何安装？ #
MacCalendar 提供手动安装与 Homebrew 安装两种方式，仅支持 macOS。
方式一：手动安装（dmg） #
-
从 GitHub Releases 下载最新版本的 dmg 格式镜像。
-
双击打开下载的 dmg 镜像。
-
拖动 MacCalendar 图标到 Applications 图标，完成安装。
-
安装完成后，在终端执行以下命令解除系统隔离：
xattr -cr /Applications/MacCalendar.app -
首次启动 App 后，打开“系统设置 → 桌面与程序坞 → 小组件”，将 MacCalendar 小组件添加到桌面。
-
如需更新，可在偏好设置中选择“检查更新”。
方式二：Homebrew 安装 #
-
在命令行执行以下命令，引入官方 tap：
brew tap bylinxx/tap -
执行安装命令：
brew install maccalendar -
安装完成后，同样在终端执行以下命令解除系统隔离：
xattr -cr /Applications/MacCalendar.app -
如需更新，可在偏好设置中选择“检查更新”。
注意：若上述命令执行后仍无法打开，请前往“系统设置 → 隐私与安全性”，在“安全性”栏点击“仍要打开”。
MacCalendar 如何卸载？ #
官网未提供专门的卸载说明，以下为 macOS 应用的通用卸载方法，可作为参考：
手动安装版本 #
- 退出 MacCalendar：在菜单栏图标上右键，选择退出；或在活动监视器中结束相关进程。
- 打开“应用程序”文件夹，将
MacCalendar.app拖入废纸篓。 - 如需彻底清理残留配置，可检查并删除以下目录中与 MacCalendar 相关的文件：
~/Library/Preferences/下的 plist 文件~/Library/Application Support/下的相关文件夹~/Library/Caches/下的缓存文件~/Library/Containers/或~/Library/Group Containers/下的沙盒数据（如存在）
- 在“系统设置 → 桌面与程序坞 → 小组件”中移除已添加的 MacCalendar 小组件。
- 清空废纸篓。
Homebrew 安装版本 #
-
在终端执行卸载命令：
brew uninstall maccalendar -
如不再需要该 tap，可执行：
brew untap bylinxx/tap -
如需彻底清理，同样可手动检查并删除上述用户目录下的残留配置文件与缓存。