1. 先搞清楚.assets 文件夹到底是什么用 Typora 写 Markdown 的朋友应该都见过这个场景一篇文档配几张图保存后左侧文件树里莫名其妙多了一个以 .assets 结尾的文件夹。想隐藏 .assets 文件夹又怕把图片搞丢这篇文章就把 Typora 文件树相关的几种做法一次说清楚。不管你是随手记笔记的普通用户还是要拿 Typora 管理知识库的重度玩家下面这些设置和思路都可以直接照着调。1.1 Typora 为什么喜欢建 .assets 文件夹很多人的第一反应是我只是贴了一张截图Typora 为什么要偷偷建目录答案藏在图片设置里。默认情况下当你从剪贴板粘贴图片到文档时Typora 会把图片保存为一个本地文件放到当前 Markdown 文档所在目录的 .assets 文件夹里然后在源码里自动写成相对路径。比如我新建一个 mynote.md粘贴两张图它大概率会生成 mynote.assets里面是自动命名的 png 图片源码里则出现这样的引用。这种设计最大的好处是文档可移植。Markdown 本身是纯文本图片如果不复制到本地而引用系统临时目录过几天临时文件被清理正文里就只剩一个裂开的图片。Typora 用“文档名 .assets”的方式把图片和正文绑定在一起复制整个文件夹时图片不会散。目录名用点开头也算一种约定俗成告诉用户“这里不是正文文档是配套资源”。不过这里有个容易踩的盲区点开头在 macOS 和 Linux 里天然被视为隐藏文件但在 Windows 的资源管理器里并不隐藏。所以很多 Windows 用户在文件树里看到 .assets觉得 Typora 不够整洁这很正常。你不需要骂它也不用急着删只要在 Typora 的文件树视图上做设置就行。1.2 隐藏文件树到底隐藏了什么动手之前先想清楚“隐藏”和“删除”完全是两件事。文件树里的显示开关只是让 Typora 界面不再列出以点开头的目录和文件磁盘上的 .assets 文件夹、里面的 png、md 中的引用路径全部原样保留。你关闭开关之后图片在 Typora 里依然正常显示只是因为侧边栏不展示它视觉上清爽了。如果你的真实需求是“这个 .assets 太碍眼我想让它别出现在文件树里”那是纯视图设置用第 2 章的开关就行如果真实需求是“我不想让每个笔记旁边都有一个附件目录”那需要改图片保存方式见第 3 章如果真实需求是“我不想让 .assets 被同步盘传走、被 Git 提交”那是文件管理层面的过滤见第 4 章。三条路对应三个目的别混着用。1.3 文件树隐藏和系统隐藏属性不是一回事很多新手会把“Typora 显示隐藏文件”和“Windows 文件属性里的隐藏”搞混。Windows 里右键文件夹勾选“隐藏”文件资源管理器里就看不到了。但在 Typora 文件树里这个属性不一定生效。Typora 的文件树过滤逻辑更倾向于按文件名是否以点开头来判断而不是去读操作系统文件属性。换句话说你在 Windows 里把 .assets 文件夹设置成“隐藏属性”Typora 该显示还是会显示反过来你把一个叫 assets没有点的文件夹在 Typora 里关掉“显示隐藏文件”它同样不会消失因为过滤条件压根不匹配。理解这一点后面看常见问题就不会绕弯了。Typora 这边的隐藏开关主要服务的是“以点开头”这种跨平台约定而不是替代系统文件管理工具。2. 方案一用文件树自身的隐藏开关直接搞定2.1 先找这个开关打开 Typora 左侧边栏切到“文件树”标签页。这个面板通常显示当前打开文件所在目录的完整结构。此时注意面板的工具栏区域一般在右上角会有一个眼睛图标或者在下拉菜单里带文字的“显示隐藏文件”也可能藏在右键菜单里。不同系统和 Typora 版本按钮位置多少有点差别但关键词非常固定显示隐藏文件。你只需要把这个开关关掉。因为 .assets 本身以点开头属于“隐藏文件”的过滤范围关掉后它会立刻从文件树消失同一目录下的其他 Markdown 文件仍然全部正常显示。如果你找不到按钮也可以去顶部菜单栏的“视图”里找同名开关再不行就打开偏好设置直接搜索“隐藏文件”四个字。用快捷键也是一种方式在部分版本里macOS 下可以试试 Command Shift . 来切换隐藏文件的显示。关掉之后仔细观察一下文件树。除了 .assets可能还会冒出 .obsidian、.trash、.git 这类隐藏目录。这个开关是一次性控制所有点开头的文件而不是只针对某一个文件夹。好处是过滤得很干净坏处是你以后想临时看某个隐藏目录得记得再打开一次。不过这个成本不高可以接受。2.2 为什么 Typora 默认不把 .assets 一直藏好按理说Typora 完全可以默认隐藏所有点开头目录为什么还有这么多人跑来问怎么隐藏我碰到过的原因主要有三种第一某些版本为了调试方便文件树默认就把隐藏文件显示出来了第二用户误点过工具栏上的眼睛图标自己没注意第三安装过第三方主题或配置主题里顺手把隐藏文件开关打开了。第三种情况最隐蔽因为你自己没动过设置但主题作者在配置文件里改过默认值。知道原理之后就不用慌。这不是有什么 bug也不是图片丢了。你只需要按 2.1 的路径重新关闭“显示隐藏文件”开关.assets 就会从文件树消失。多说一句尽量不要为了这个去改 Typora 主题 CSS 来隐藏文件树节点成本高、不通用软件每次更新都可能变化。官方既然提供了显示/隐藏隐藏文件的开关用开关就是最稳的做法。2.3 开关解决不了时试试这两个检查方向有少数情况你明明关掉了“显示隐藏文件”.assets 还是挂在文件树里。我遇到这种问题一般先检查两件事一是当前打开的文件是否真的在文件树根目录下有时候你切到了“文件树”面板但显示的是另一个文件夹.assets 不在这个位置自然不受同一开关控制二是目录名是不是真的以点开头。如果目录名是 assets 而不是 .assets那它不是隐藏文件开关当然不管它。第二个问题的解法也很直接把目录名改成 .assets然后在 Typora 里确认引用路径同步更新。不过改目录名要小心Markdown 源码里的路径是相对引用目录一改名原来的assets/xxx.png就失效了。你需要在 Typora 里重新插入图片或者用文本替换把旧的路径前缀改成新的。更稳妥的做法是改之前先复制一份用编辑器批量替换路径最后再用文件树验证图片是否还能正常显示。3. 方案二调整图片保存方式从源头减少 .assets3.1 把图片统一放到一个目录如果你不是只想“眼不见为净”而是受不了每个笔记旁边都挂一个 .assets 文件夹那更值得做的是改图片保存方式。打开偏好设置找到“图像”这一栏里面有一个“插入图片时”的选项。默认经常是“复制图片到 ./${filename}.assets 文件夹”你把它改成“复制图片到指定路径”然后在输入框里填一个固定的相对路径比如./attachments或者../images。先说./attachments它表示当前 Markdown 文件所在的文件夹下建一个 attachments 目录所有图片都放进去。适合文件数量不多、目录层级浅的笔记场景。再说../images它表示上级目录下的 images 文件夹适合你希望整个项目所有子目录的图片都汇总到一个共用图片库里。举个例子你的笔记结构是“项目A/笔记/note.md”设置../images后图片会放到“项目A/images”这样项目根目录下只有一个附件库查找和备份都方便。有一个细节要提醒路径最好写成相对路径别写成D:/我的图片/xxx这种绝对路径。相对路径的意义是你把整个项目文件夹从电脑 A 复制到电脑 B图片依然能通过 Markdown 源码里的相对路径找到绝对路径一旦换电脑、换用户目录图片就全裂了。Typora 在生成引用时一般也会优先保留相对路径但你在输入框里填路径时仍然要养成写相对路径的习惯。3.2 干脆不复制图片可以吗有人会想我直接选“不复制图片”或者“上传图片到图床”本地不就没有 .assets 了吗理论上是但我不太建议普通笔记用户这么做尤其是经常用截图粘贴的人。选了不复制Typora 会保留图片原始路径如果你贴的是系统剪贴板截图Typora 可能先把它放到一个临时位置再引用这个临时位置一旦被系统清理图片就废了。本地文件的引用呢又要求你手动维护图片路径很容易打乱 Markdown 的可移植性。图床方案倒是能彻底绕过本地图片目录适合写博客、公众号这类确定要发布的场景。图片传到云端Markdown 里引用的是网络 URL本地自然不会多出 .assets。但代价是离线时无法显示图片而且图床如果失效历史文章里的图片全部阵亡。所以我的个人看法是追求本地管理就老老实实用“复制到指定路径”别为了省目录把风险做上去。3.3 旧文档的 .assets 怎么处理最好改完设置之后历史文档里已经存在的 .assets 并不会自动消失你需要在文件管理器里手动整理或者用批量替换工具把旧的图片引用路径更新到新目录。这个迁移动作不要急先备份再小范围试确认没问题后再批量处理。比如我现在用的迁移流程分三步第一步新建一个测试文档插一张图确认新路径规则生效第二步找两篇旧文档把它们的图片手动移动到新附件目录同时改掉 Markdown 里的图片引用路径打开确认显示正常第三步再按同样的规则处理剩余文档。整个过程不需要什么特殊工具小巧的批量替换就够用。唯一的提醒是Markdown 里的路径如果是从 Typora 自动生成的格式一般很规整批量替换时注意别把标题里的同名文本也换掉了所以替换前先看一两个样例最稳妥。4. 方案三从项目结构上做整理而不是单纯隐藏4.1 用顶层附件目录代替散落的 assets如果你的笔记已经攒了几百篇每个 md 旁边都有个 .assets这时候用隐藏开关只是治标项目维护起来依然难受。我更推荐在一开始就规划一个顶层附件目录让 Markdown 的图片引用都指向同一个地方。比如这样的结构docs/01-读书笔记/xxx.mddocs/02-项目记录/yyy.mddocs/attachments/images/xxx.png设置方式还是“复制图片到指定路径”路径写成相对于各子目录的路径。比如 01-读书笔记 里的 md引用顶层附件目录可以填../attachments/images如果笔记再深一层就写成../../attachments/images。路径的层数根据实际目录深度来定核心原则是所有文档共用唯一的附件目录文件树里只有一处图片存放点。这种做法的优势不光是文件树干净。你想做全库备份只需要把 docs 目录整个拷走想迁移到 Obsidian、思源或其他 Markdown 工具也可以直接改变量识别新附件目录。相比之下散落的 .assets 结构在迁移时反而麻烦因为每个文档的图片都在自己旁边改路径的工作量是重复的。4.2 Git 和同步盘要单独处理别被“隐藏”骗了很多人在文件树里隐藏了 .assets就以为 Git 提交、网盘同步时它也不会出现这是个很大的误解。文件树开关只影响 Typora 界面显示不会影响系统里的文件。只要真实的 .assets 目录还在Git 就会把它纳入未跟踪文件同步盘也会照常上传。如果不想让 Git 提交图片或者临时文件正确做法是在仓库根目录的 .gitignore 里写.assets/这个规则会忽略所有直接位于某个目录下的 .assets 文件夹。如果你希望忽略任意层级的 .assets可以写**/.assets/需要特别注意如果 .assets 里的图片之前已经被 Git 跟踪过单纯加 .gitignore 不会让它们消失。你需要先执行一次解除跟踪的命令比如git rm -r --cached .assets然后提交一次之后这些文件才会真正被 Git 忽略。同步盘的逻辑类似在云盘客户端里找到 .assets 或 attachments 目录加入同步排除列表。视图隐藏、Git 忽略、同步排除是三件独立的事别指望一个设置全搞定。5. 避坑指南隐藏之后最容易踩的坑5.1 看不见不等于可以乱删关闭显示隐藏文件之后最容易犯的错是忘记 .assets 的真实存在。有次我在文件树里看不见 .assets觉得清爽了于是只把几个 md 文件复制到新电脑结果打开后所有图片全部空白。原因很简单Markdown 里的相对路径还指向 .assets但 .assets 文件夹没跟着走。所以你要建立一个基本认知文件树隐藏的只是视觉条目不是目录本身。凡是引用本地图片的 Markdown迁移时要么带着附件目录要么用 Typora 的导出功能把文档和资源打包。很多 Markdown 编辑器都有“导出”为 HTML 或 PDF 的功能导出时图片会以内嵌或压缩包形式带走这比手动复制 md 文件稳妥得多。5.2 同步和备份时别漏下附件目录用网盘同步笔记目录是很多人推荐的工作流但也容易踩坑。比如你在电脑 A 上关掉了文件树里的 .assets然后电脑 B 打开同一个工作目录发现图片无法显示。大概率不是 Typora 的问题而是同步盘漏掉了附件目录或者你人在电脑 B 本地新建的文件夹里把同步目录当成了普通文件夹在操作。同步盘本身不会因为你在 Typora 里隐藏了目录就停止同步只要真实目录在同步范围内它就会继续上传下载。不想同步就去同步软件里排除指定目录。备份同理如果你用压缩工具打包笔记不要只选中“看起来像文档”的 md 文件要把整个项目文件夹带上。隐藏视图不会改变磁盘文件只会掩盖你的判断。5.3 版本升级之后隐藏设置别被冲掉Typora 更新到新版本后有一部分用户会遇到隐藏文件开关自己“变回去”的情况。这通常是因为新版软件重置了偏好设置或者界面布局改了开关入口换了地方。遇到 .assets 重新出现在文件树里先别急着找第三方工具回到偏好设置和视图菜单里把“显示隐藏文件”重新关掉就好。这里也要提一句不要从网上随便下载所谓的“优化版”“绿色版”来替代正版很多来路不明的版本为了便利默认就把文件树隐藏文件开关打开了还有可能夹带私货。Typora 本身是很好的工具如果你经常用建议支持正版至少也用官方渠道下载安装包。稳定、干净、没有额外风险比什么都重要。6. 常见问题速查表6.1 五类高频问题对照表问题表现常见原因解决办法文件树里 .assets 仍然显示“显示隐藏文件”开关处于开启状态关掉文件树工具栏或视图菜单里的同名开关找不到“显示隐藏文件”入口版本界面不同入口位置有差异到偏好设置搜索“隐藏”或试试 macOS 快捷键 Command Shift .只有 assets无点目录无法隐藏该目录名不以点开头改名成 .assets 或 .attachments再配合显示隐藏开关隐藏后网盘仍同步了一堆图片视图设置不影响同步到同步盘客户端的排除规则里加入 .assets 目录更新 Typora 后 .assets 又出现偏好设置被重置或默认值变化重新关闭“显示隐藏文件”按需检查其他偏好这张表基本覆盖了我问得最多的几种情况。如果你是刚接触 Typora 的新人看到 .assets 出现的第一反应不应该是有病毒而是先去理解它的作用。理解了作用再根据自己的使用习惯选择隐藏、集中或忽略。6.2 我的最终建议把这些方案放在一起我个人在实际项目里最常用的是组合方案图片保存路径设置为统一的附件目录目录命名用.attachments然后关闭文件树的“显示隐藏文件”。这样日常写作完全看不到附件目录文件树里全是正文文档知识库结构也清晰。同步和 Git 层面再单独加忽略规则三层各干各的事互相不干扰。如果你只是偶尔一两篇带图的笔记不想做任何迁移最简单的做法就是直接关掉“显示隐藏文件”开关三秒钟解决问题。至于那些还在纠结“要不要为了隐藏去改配置文件”的人我的态度很明确别折腾。Typora 给你开关你就用开关Typora 没给你某项细粒度隐藏能力那就用路径规划去解决。工具是拿来写字的不是拿来跟文件夹抠劲的。最后再分享一个小技巧隐藏之后如果你偶尔需要在文件树里快速找到某张图片重新打开“显示隐藏文件”开关用完再关上切换成本并不高不用一直开着。