CNB 云原生开发环境配置说明

本项目已配置完整的 CNB 云原生开发环境，包含以下文件：

• 配置了自定义 Docker 镜像构建（通过 .ide/Dockerfile）
• 设置了备用镜像 cnbcool/default-dev-env:latest
• 配置了自动启动任务：环境初始化、依赖安装、子模块更新
• 启用 VSCode 和 Docker 服务

• 基于 Node.js 20
• 预装了针对 Vue + TypeScript 的 VSCode 扩展：
  • Vue.volar (Vue 语言支持)
  • Vue.vscode-typescript-vue-plugin
  • dbaeumer.vscode-eslint (ESLint)
  • esbenp.prettier-vscode (Prettier)
  • tencent-cloud.coding-copilot (腾讯云 AI 助手)
• 配置了 npm 镜像源以加速国内依赖安装
• 设置了环境变量和字符集

• npm run cnb:setup - 安装依赖并配置环境
• npm run cnb:dev - 完整启动流程（配置 + 开发）

1. 将代码推送到 CNB 关联的代码仓库
2. 在 CNB 工作空间中启动云原生开发环境
3. CNB 会自动：
   • 使用 .ide/Dockerfile 构建开发环境镜像
   • 执行 .cnb.yml 中配置的初始化任务
   • 启动 VSCode 服务
4. 启动完成后，在终端运行：

   npm run dev
   

5. 访问 http://localhost:5173 查看开发服务器

# 测试环境配置脚本
npm run cnb:setup

# 启动开发服务器
npm run dev

每次启动云原生开发环境时，.cnb.yml 中的 stages 会自动执行：

1. setup-env 阶段

   • 设置 NODE_ENV 环境变量
   • 检查并安装依赖（如果 node_modules 不存在）
   • 初始化并更新 Git 子模块（如果有）

2. dev-info 阶段

   • 显示开发环境信息
   • 展示可用命令列表

• cnbcool.cnb-welcome - CNB 欢迎页
• Vue.volar - Vue 语言支持
• Vue.vscode-typescript-vue-plugin - TypeScript 支持
• dbaeumer.vscode-eslint - 代码检查
• esbenp.prettier-vscode - 代码格式化
• redhat.vscode-yaml - YAML 支持
• waderyan.gitblame - Git Blame
• mhutchie.git-graph - Git 图形化
• donjayamanne.githistory - Git 历史
• tencent-cloud.coding-copilot - 腾讯云 AI 助手

• 5173 - Vite 开发服务器端口

如果 .ide/Dockerfile 构建失败，CNB 会自动使用备用镜像 cnbcool/default-dev-env:latest，确保开发环境能够启动。

已在 Dockerfile 中配置了 npm 镜像源 https://registry.npmmirror.com，加速国内依赖下载。

修改 .ide/Dockerfile，添加所需的系统包或工具。

• CNB 官方文档
• 自定义开发环境