企业官网建设流程全解析

1. 先搞清楚：.assets 文件夹到底是什么

用 Typora 写 Markdown 的朋友，应该都见过这个场景：一篇文档配几张图，保存后左侧文件树里莫名其妙多了一个以 .assets 结尾的文件夹。想隐藏 .assets 文件夹，又怕把图片搞丢，这篇文章就把 Typora 文件树相关的几种做法一次说清楚。不管你是随手记笔记的普通用户，还是要拿 Typora 管理知识库的重度玩家，下面这些设置和思路都可以直接照着调。

1.1 Typora 为什么喜欢建 .assets 文件夹

很多人的第一反应是：我只是贴了一张截图，Typora 为什么要偷偷建目录？答案藏在图片设置里。默认情况下，当你从剪贴板粘贴图片到文档时，Typora 会把图片保存为一个本地文件，放到当前 Markdown 文档所在目录的 .assets 文件夹里，然后在源码里自动写成相对路径。比如我新建一个 mynote.md，粘贴两张图，它大概率会生成 mynote.assets，里面是自动命名的 png 图片，源码里则出现![](mynote.assets/xxx.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. 方案二：调整图片保存方式，从源头减少 .assets

3.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.md
• docs/02-项目记录/yyy.md
• docs/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 五类高频问题对照表

这张表基本覆盖了我问得最多的几种情况。如果你是刚接触 Typora 的新人，看到 .assets 出现的第一反应不应该是有病毒，而是先去理解它的作用。理解了作用，再根据自己的使用习惯选择隐藏、集中或忽略。

6.2 我的最终建议

把这些方案放在一起，我个人在实际项目里最常用的是组合方案：图片保存路径设置为统一的附件目录，目录命名用.attachments，然后关闭文件树的“显示隐藏文件”。这样日常写作完全看不到附件目录，文件树里全是正文文档，知识库结构也清晰。同步和 Git 层面再单独加忽略规则，三层各干各的事，互相不干扰。

如果你只是偶尔一两篇带图的笔记，不想做任何迁移，最简单的做法就是直接关掉“显示隐藏文件”开关，三秒钟解决问题。至于那些还在纠结“要不要为了隐藏去改配置文件”的人，我的态度很明确：别折腾。Typora 给你开关，你就用开关；Typora 没给你某项细粒度隐藏能力，那就用路径规划去解决。工具是拿来写字的，不是拿来跟文件夹抠劲的。最后再分享一个小技巧：隐藏之后，如果你偶尔需要在文件树里快速找到某张图片，重新打开“显示隐藏文件”开关，用完再关上，切换成本并不高，不用一直开着。