netdisk-fast-download/web-front/doc/MONACO_EDITOR_NPM.md

Monaco Editor NPM包配置说明

✅ 已完成的配置

1. NPM包安装

已在 package.json 中安装：

• monaco-editor: ^0.55.1 - Monaco Editor核心包
• @monaco-editor/loader: ^1.4.0 - Monaco Editor加载器
• monaco-editor-webpack-plugin: ^7.1.1 - Webpack打包插件（devDependencies）

2. Webpack配置

在 vue.config.js 中已配置：

new MonacoEditorPlugin({
  languages: ['javascript', 'typescript', 'json'],
  features: ['coreCommands', 'find'],
  publicPath: process.env.NODE_ENV === 'production' ? './' : '/'
})

3. 组件配置

在 MonacoEditor.vue 和 Playground.vue 中已配置：

// 配置loader使用本地打包的文件，而不是CDN
if (loader.config) {
  const vsPath = process.env.NODE_ENV === 'production' 
    ? './js/vs'  // 生产环境使用相对路径
    : '/js/vs';  // 开发环境使用绝对路径
  
  loader.config({ 
    paths: { 
      vs: vsPath
    }
  });
}

---

🔍 工作原理

打包流程

1. monaco-editor-webpack-plugin 在构建时将 Monaco Editor 文件打包到 js/vs/ 目录
2. @monaco-editor/loader 通过配置的路径加载本地文件
3. 不再从 CDN（如 https://cdn.jsdelivr.net）加载

文件结构（构建后）

nfd-front/
  ├── js/
  │   └── vs/
  │       ├── editor/
  │       ├── loader/
  │       ├── base/
  │       └── ...
  └── index.html

---

🧪 验证方法

1. 检查网络请求

打开浏览器开发者工具 → Network标签：

• ✅ 应该看到请求 /js/vs/... 或 ./js/vs/...
• ❌ 不应该看到请求 cdn.jsdelivr.net 或其他CDN域名

2. 检查构建产物

cd web-front
npm run build
ls -la nfd-front/js/vs/

应该看到 Monaco Editor 的文件被打包到本地。

3. 离线测试

1. 断开网络连接
2. 访问 Playground 页面
3. ✅ 编辑器应该正常加载（因为使用本地文件）
4. ❌ 如果使用CDN，编辑器会加载失败

---

📝 修改的文件

1. ✅ web-front/src/components/MonacoEditor.vue

   • 添加了 loader.config() 配置，明确使用本地路径

2. ✅ web-front/src/views/Playground.vue

   • 在 initMonacoTypes() 中添加了相同的配置

3. ✅ web-front/vue.config.js

   • 添加了 publicPath 配置，确保路径正确

---

🚀 部署

开发环境

cd web-front
npm install  # 确保依赖已安装
npm run serve

访问 http://127.0.0.1:6444/playground，编辑器应该从本地加载。

生产环境

cd web-front
npm run build

构建后，Monaco Editor 文件会打包到 nfd-front/js/vs/ 目录。

---

⚠️ 注意事项

1. 文件大小

Monaco Editor 打包后会增加构建产物大小（约2-3MB），但这是正常的。

2. 首次加载

• 开发环境：文件从 webpack dev server 加载
• 生产环境：文件从本地 js/vs/ 目录加载

3. 缓存

浏览器会缓存 Monaco Editor 文件，更新后可能需要清除缓存。

---

🔧 故障排查

问题：编辑器无法加载

检查：

1. 确认 npm install 已执行
2. 检查浏览器控制台是否有错误
3. 检查 Network 标签，确认文件路径是否正确

问题：仍然从CDN加载

解决：

1. 清除浏览器缓存
2. 确认 loader.config() 已正确配置
3. 检查 vue.config.js 中的 publicPath 配置

问题：构建后路径错误

解决：

• 检查 publicPath 配置
• 确认生产环境的相对路径 ./js/vs 正确

---

✅ 优势

1. 离线可用 - 不依赖外部CDN
2. 加载速度 - 本地文件通常比CDN更快
3. 版本控制 - 使用固定版本的Monaco Editor
4. 安全性 - 不依赖第三方CDN服务
5. 稳定性 - CDN故障不影响使用

---

配置状态: ✅ 已完成
验证状态: ⚠️ 待测试
建议: 运行 npm run build 并检查构建产物