3个维度掌握Oh My CV：本地化Markdown简历构建指南

解决技术简历制作痛点的零配置实现方案

一、功能特性解析

如何通过微模块架构实现功能解耦？ 📦

Oh My CV采用11个独立功能包实现模块化设计，每个包专注于特定功能领域。其中dynamic-css模块负责样式动态计算，front-matter处理Markdown元数据解析，gfonts-loader实现谷歌字体按需加载。各模块通过packages/utils/src/common.ts实现跨模块通信，这种架构使主题定制功能（site/src/components/edit/toolbar/ThemeColor.vue）可以独立迭代，不影响核心编辑功能。

如何实现浏览器内本地化简历编辑？ 🔧

该工具核心优势在于完全浏览器内运行，所有数据存储在本地。关键实现位于site/src/utils/database.ts，通过IndexedDB API实现简历数据的持久化存储。编辑器组件（site/src/components/edit/Editor.vue）与预览组件（site/src/components/edit/Preview.vue）通过Vuex状态管理（site/src/composables/stores/data.ts）保持实时同步，实现"所见即所得"的编辑体验。

二、核心技术原理

简历渲染流程是如何实现的？ ⚙️

简历渲染经历三个关键阶段：首先通过packages/markdown-it-katex/src/index.ts处理LaTeX公式，然后由packages/dynamic-css/src/index.ts生成动态样式，最后通过site/src/components/shared/ResumeRender.vue完成最终渲染。当用户修改字体设置时，信号通过style状态管理（site/src/composables/stores/style.ts）触发重新计算，整个过程基于Vue的响应式系统实现自动更新。

核心技术点：Oh My CV创新性地将Markdown解析、样式计算和PDF导出全部在浏览器内完成，无需后端服务支持，这使其可以完全离线运行。

配置优先级机制是怎样的？ 📝

系统采用三级配置优先级：用户实时设置（最高）→ 简历文件元数据 → 全局默认配置。以字体设置为例，优先使用FontFamily.vue中用户选择的值，其次读取front-matter中的配置，最后fallback到site/src/utils/constants/default.ts定义的默认值。site/src/utils/index.ts中的getEffectiveConfig函数统一处理配置合并逻辑。

三、实战应用指南

如何定制个性化简历主题？ 🎨

主题定制通过修改site/src/composables/stores/style.ts中的theme状态实现，主要包括三个维度：基础色板（--primary, --secondary等CSS变量）、排版系统（font-family, line-height）和布局参数（margin, padding, paper-size）。修改后通过site/src/utils/css.ts中的applyTheme方法实时注入到文档根元素，实现主题的即时切换。

如何实现PDF导出功能？ 🖨️

PDF导出功能通过浏览器打印API实现，核心代码位于site/src/components/shared/ResumeRender.vue的generatePDF方法。该方法通过创建隐藏的打印样式表，临时调整页面布局，然后调用window.print()触发打印对话框。关键优化点在于site/src/assets/css/edit.css中定义的打印媒体查询样式，确保PDF输出效果与预览一致。

进阶技巧：通过修改site/src/utils/constants/data.ts中的paperSizes配置，可以添加自定义纸张尺寸，满足特殊简历格式需求。

通过以上三个维度的解析，我们可以看到Oh My CV如何通过模块化设计、响应式状态管理和浏览器原生API，实现了一个功能完备的本地化简历构建工具。其核心价值在于将复杂的简历排版逻辑封装为简单易用的交互界面，同时保持了高度的可定制性，非常适合技术人员快速制作专业简历。