logo
0
0
WeChat Login
docs: 添加开发环境配置说明和 Dockerfile

开发环境配置推荐方式

在使用云开发环境时,推荐根据实际需求选择两种方式来初始化环境:

1. 轻量 / 临时环境:使用 env 自动安装

适用于:

  • 依赖较少
  • 安装过程简单(几秒~几十秒)
  • 不要求严格环境一致性
  • 偶尔使用或快速验证

可以通过 env.CNB_WELCOME_CMD 在首次进入终端时自动执行安装:

env:
  CNB_WELCOME_CMD: |
    curl https://mise.run/zsh | sh
    source ~/.zshrc
    mise use -g go@latest
    mise use -g node@24

特点:

  • 上手简单,无需维护 Dockerfile
  • 修改配置立即生效
  • 每次新环境都会重新安装(可能稍慢)

👉 适合:个人开发、PoC、Demo、简单项目


2. 稳定 / 长期环境:使用 Dockerfile 固化

适用于:

  • 依赖较多或安装耗时长
  • 需要固定版本(避免“我这能跑你那不行”)
  • 团队协作
  • 希望环境启动即完成(无需等待安装)

通过 Dockerfile 预构建环境:

docker:
  build: .ide/Dockerfile

示例:

FROM cnbcool/default-dev-env:latest

RUN curl https://mise.run | sh \
    && ~/.local/bin/mise use -g go@latest \
    && ~/.local/bin/mise use -g node@24

特点:

  • 环境一致性强
  • 启动速度快(已预装)
  • 更适合团队协作
  • 需要维护 Dockerfile

👉 适合:正式项目、多人协作、复杂依赖环境


总结

场景推荐方式
快速尝试 / 临时开发env
长期使用 / 团队协作Dockerfile

简单来说:

  • 能用 env 解决的,优先用 env
  • 一旦环境开始“变重”或需要稳定复用,就切换到 Dockerfile