如何配置Visual Studio Code本地调试Docsify.js解决.md文件读取失败问题

双击本地index.html时浏览器使用file://协议加载页面，受同源安全策略限制，页面内的JavaScript无法读取同目录下的.md格式文档——这是浏览器层面的默认安全规则，和Edge Tools插件本身的配置无关，只要走file://协议访问，Docsify的动态拉取渲染逻辑就会失效，必须通过HTTP协议访问本地服务才能正常运行。

不需要修改浏览器全局安全设置（这类操作会带来不必要的安全风险，不推荐），按以下步骤配置即可：

• 安装VS Code的Live Server扩展，该扩展可快速启动本地轻量静态HTTP服务，无需额外搭建服务环境
• 替换原有launch.json配置，核心改动是将原本指向本地磁盘路径的url替换为本地服务地址，新增webRoot参数映射项目根目录，完整配置如下：

{
    "configurations": [
        {
            "type": "pwa-msedge",
            "name": "Launch Microsoft Edge against local server",
            "request": "launch",
            "runtimeArgs": [
                "--remote-debugging-port=9222"
            ],
            "url": "http://127.0.0.1:5500/index.html",
            "webRoot": "${workspaceFolder}",
            "presentation": {
                "hidden": true
            }
        },
        {
            "type": "pwa-msedge",
            "name": "Launch Microsoft Edge in headless mode",
            "request": "launch",
            "runtimeArgs": [
                "--headless",
                "--remote-debugging-port=9222"
            ],
            "url": "http://127.0.0.1:5500/index.html",
            "webRoot": "${workspaceFolder}",
            "presentation": {
                "hidden": true
            }
        },
        {
            "type": "vscode-edge-devtools.debug",
            "name": "Open Edge DevTools",
            "request": "attach",
            "url": "http://127.0.0.1:5500/index.html",
            "webRoot": "${workspaceFolder}",
            "presentation": {
                "hidden": true
            }
        }
    ],
    "compounds": [
        {
            "name": "Launch Edge Headless and attach DevTools",
            "configurations": [
                "Launch Microsoft Edge in headless mode",
                "Open Edge DevTools"
            ]
        },
        {
            "name": "Launch Edge and attach DevTools",
            "configurations": [
                "Launch Microsoft Edge against local server",
                "Open Edge DevTools"
            ]
        }
    ]
}

• 启动调试前，右键点击项目内的index.html，选择Open with Live Server，待右下角提示服务启动（默认监听5500端口）后，再启动对应Edge调试配置，即可正常加载渲染md文档。

如果本地已安装Node.js环境，也可以直接使用Docsify自带的CLI工具启动本地服务，执行对应启动命令后服务默认运行在3000端口，将上述配置中的url字段改为http://127.0.0.1:3000/index.html即可，效果一致。

临时测试时也可给Edge添加--allow-file-access-from-files启动参数绕过本地文件访问限制，但该方式会降低浏览器运行安全性，不建议作为长期调试方案使用。

内容的提问来源于stack exchange，提问作者Enrico