HTML文件必须保存在工作区目录中，不能是未保存的临时文件；Live Server等运行方式依赖真实磁盘路径，需先打开文件夹再创建并保存HTML文件。
HTML 文件必须放在工作区根目录或子目录中，不能是未保存的临时文件
VS Code 的 Live Server、open in browser、调试配置等所有运行方式，都依赖一个真实存在的磁盘路径。如果你在编辑器里新建了一个 Untitled-1，没保存就右键“Open with Live Server”，会直接报错 Cannot open file: file:////Untitled-1。
这意味着：你得先创建文件夹 → 在 VS Code 中用“打开文件夹”加载它 → 再新建 index.html 并保存。路径层级本身没有硬性限制，但建议按用途分层，避免后期混乱。
- 根目录放
index.html、about.html等入口页，方便 Live Server 默认访问/ - 静态资源统一进
css/、js/、images/子目录（不是必须，但能防止根目录堆满文件） - 不要把 HTML 放在
node_modules/或.vscode/这类系统目录下——Live Server 会跳过它们，且可能触发权限错误
webVisualEditor.rootPath 影响相对路径解析，和目录结构强绑定
当你用 vscode-web-visual-editor 插件拖拽元素、修改样式时，如果页面里写了 <link rel="stylesheet" href="/css/main.css">，插件需要知道这个 /css/ 是从哪开始算“根”。这就是 webVisualEditor.rootPath 的作用。
它的值不是 URL 路径，而是本地文件系统路径（比如 "./" 或 "./src"）。设错会导致预览里 CSS 加载 404，但源码里明明路径是对的。
立即学习“前端免费学习笔记（深入）”；
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
- 默认为空字符串
""，表示以当前 HTML 文件所在目录为基准解析/xxx开头的路径 - 如果你的 HTML 在
dist/index.html，而 CSS 在dist/css/main.css，那webVisualEditor.rootPath应设为"./dist" - 设成
"./src"却把 HTML 放在dist/下，就会导致/css/main.css被错误拼成./src/css/main.css，找不到文件
模板文件（.ejs/.pug）必须和 Express 服务目录结构对齐
运行 index.ejs 不是“打开文件”，而是启动 Node.js 服务后由 Express 渲染。这时候目录结构不再只是组织文件，而是直接参与路由匹配和视图查找逻辑。
关键配置是 app.set('views', './views') 和 app.set('view engine', 'ejs')。Express 会严格按这个路径去找 index.ejs，不会自动向上或向下搜索。
- 如果你把
index.ejs放在项目根目录，但app.set('views', './views')没改，服务启动后访问/就会报错Failed to lookup view "index" - 多级嵌套模板（如
views/admin/dashboard.ejs）要靠路由app.get('/admin', ...)显式指定res.render('admin/dashboard')，路径写错就 404 - 静态资源（CSS/JS）也要同步配
app.use(express.static('public'))，否则<script src="/js/app.js"></script>会 404，和 HTML 目录无关，只和express.static()指向的目录有关
Live Server 的端口行为和目录无关，但跨域问题会暴露结构缺陷
Live Server 默认起在 http://127.0.0.1:5500，它把整个工作区根目录当作 Web 根路径（/）。这意味着 http://127.0.0.1:5500/about.html 对应的是 ./about.html，http://127.0.0.1:5500/js/main.js 对应的是 ./js/main.js。
表面看和目录结构无关，但一旦你引入外部 API、调用 fetch('/api/users')，浏览器实际发请求到 http://127.0.0.1:5500/api/users —— 这个路径根本不存在，除非你额外配代理或后端。很多人误以为是“路径写错了”，其实是没意识到 Live Server 只服务静态文件，不处理动态路由。
- 前端开发阶段，用
fetch('http://localhost:3000/api/users')才合理，前提是后端真跑在 3000 端口 - 如果硬要用相对路径又想绕过 CORS，得在 Live Server 插件设置里加
"liveServer.settings.AdvanceCustomBrowserUrl": true，再手动配代理规则（复杂且易出错） - 最稳的做法：静态文件用 Live Server，API 请求指向真实后端，两者端口分离，目录结构只管前端资源摆放
