Obsidian社区插件市场打不开是因raw.githubusercontent.com等域名国内无法直连，非插件或版本问题；可关闭安全模式后通过PKMer、手动下载或proxy-github插件三种方式绕过解决。
Mac系统上Obsidian社区插件市场打不开、搜索框转圈、点击“浏览”无响应，本质是raw.githubusercontent.com等GitHub资源域名在国内无法直连，不是插件本身故障，也不是Obsidian版本问题。官方市场加载失败后，你仍能完整安装任意插件，只需绕过浏览器渲染环节，直接落盘生效。
确认基础前提：关闭安全模式并启用社区插件
打开 Obsidian → 点击左下角齿轮图标进入设置 → 左侧菜单选择「社区插件」→ 先确保顶部开关已开启（显示为「已打开社区插件」）→ 向下找到「安全模式」开关，【必须关闭】 → 系统弹出风险提示时勾选确认并点击「确定」→ 此时页面应刷新出「浏览」按钮。若未出现，重启 Obsidian 再试一次。
这一步跳过会导致后续所有安装方式都无效——插件文件即使放对位置，也会被 Obsidian 主动拒绝加载。
方法一：用 PKMer 插件市场（推荐国内用户首选）
PKMer 是专为国内网络优化的第三方插件市场，提供 CDN 加速和中文界面，无需代理即可搜索、安装、更新绝大多数社区插件。
1. 打开 Safari 或 Chrome，访问 PKMer 官网（搜索「PKMer Obsidian」即可找到最新地址，通常以 .dev 或 .xyz 结尾）→ 下载最新版 PKMer 插件 ZIP 包。
2. 解压 ZIP 文件，得到一个名为 pkmer 的文件夹 → 打开你的 Obsidian 笔记库根目录 → 按 Command+Shift+. 显示隐藏文件 → 进入 .obsidian/plugins 目录（如无此文件夹，请手动新建）→ 将解压出的 pkmer 文件夹整个拖入该 plugins 目录。
3. 重启 Obsidian → 设置 → 社区插件 → 在列表中找到「PKMer」→ 点击右侧「启用」→ 启用后左侧边栏会出现 PKMer 图标 → 点击进入 → 在搜索框输入插件名（如 Dataview），选中后点击「一键安装」→ 安装完成后自动出现在社区插件列表，需手动点击「启用」才生效。
注意：PKMer 自身不自动更新，首次安装后建议在它的界面右上角点「检查更新」，确保用的是最新版市场引擎。
方法二：从 GitHub 手动下载安装（适合 PKMer 未收录或需指定版本）
当你需要安装测试版、旧版、或作者尚未提交到 PKMer 的插件时，必须走这条路径。关键不是“下载整个仓库”，而是精准获取三个必要文件。
方法一：通过 Releases 页面下载（最稳妥）
打开插件 GitHub 仓库主页 → 点击右上角「Releases」→ 找到最新 Tag（如 v0.5.12）→ 展开 Assets → 下载带 -dist.zip 后缀的压缩包（没有就选 main.js + manifest.json + styles.css 三个文件单独下载）。
方法二：用 GitCode 镜像站（备用方案）
在浏览器中搜索「插件名 site:gitcode.net」→ 进入镜像仓库 → 同样找 Releases → 下载对应 zip。
下载完成后，新建一个纯英文命名的文件夹（例如 dataview，不能含空格或中文）→ 将下载的 main.js、manifest.json、styles.css（如有）全部放入该文件夹 → 把整个文件夹拖进 笔记库/.obsidian/plugins/ 目录 → 重启 Obsidian → 设置 → 社区插件 → 找到该插件名称 → 点击「启用」。
【切记：manifest.json 必须存在且格式正确，否则插件条目根本不会出现在列表里】
方法三：用 obsidian-proxy-github 插件强制代理（一劳永逸型）
这个插件本质是给 Obsidian 内置网络请求加一层本地代理转发，不依赖系统全局代理，对 M1/M2/M3 Mac 兼容性好，适合长期使用多个海外源插件的用户。
1. 访问 GitHub 搜索「obsidian-proxy-github」→ 进入 juqkai/obsidian-proxy-github 仓库 → 点击「Releases」→ 下载最新版 ZIP。
2. 解压后得到 obsidian-proxy-github-master 文件夹 → 重命名为 proxy-github（去掉 -master，避免路径识别异常）→ 拖入 笔记库/.obsidian/plugins/。
3. 重启 Obsidian → 设置 → 社区插件 → 找到「Proxy GitHub」→ 启用 → 点击右侧齿轮图标进入配置 → 勾选「启用代理」→ 保存 → 返回设置页，再次点击「社区插件」→「浏览」，此时市场应正常加载。
此后所有通过官方市场安装的插件，都会经由该代理完成下载，无需重复配置。
