现代化的 Jupyter Lab 开发环境，支持中文，预装常用数据科学库和美化插件。

• Python 3.12
• JupyterLab 4.x 最新版本
• 完整中文支持：界面语言包 + 中文字体 + matplotlib 中文显示
• Maple Font：使用 Maple Mono NF CN 作为编辑器和界面字体（支持中文和 Nerd Font 图标）
• 预装常用库：pandas, numpy, scipy, matplotlib, seaborn, plotly, scikit-learn, xgboost
• 功能插件：Git 集成、LSP 代码补全、执行时间显示、资源监控
• 美化主题：JupyterLab Dark 官方暗色主题
• oh-my-zsh：默认终端为 zsh + ys 主题

复制 .env.example 为 .env，设置登录密码：

cp .env.example .env
# 编辑 .env 文件，修改 JUPYTER_PASSWORD 的值

如果不需要密码，留空即可：JUPYTER_PASSWORD=

docker-compose up -d

打开浏览器访问：http://localhost:8889（首次启动需要等待构建，约 2-3 分钟）

使用你在 .env 中设置的密码登录

docker-compose down

修改 requirements.txt 后重新构建镜像：

docker-compose build
docker-compose up -d

better-jupyter/
├── .ide/                       # Docker 和 CI 相关配置
│   ├── Dockerfile              # Docker 镜像定义
│   ├── config/
│   │   └── jupyter_lab_config.py   # JupyterLab 配置
│   └── scripts/
│       └── init_jupyter.sh     # 初始化脚本（配置中文和主题）
├── requirements.txt            # Python 依赖（可自由修改）
├── docker-compose.yml          # Docker Compose 配置（本地开发）
├── .env                        # 环境变量（密码等配置）
├── .env.example                # 环境变量示例
├── .cnb.yml                    # CI 配置
└── notebooks/                  # Notebook 文件目录（持久化）

编辑 requirements.txt，然后重新构建镜像：

docker-compose build
docker-compose up -d

编辑 docker-compose.yml 中的端口映射：

ports:
  - "8889:8888"  # 左边是本机端口，右边是容器端口

编辑 .env 文件，修改 JUPYTER_PASSWORD 的值，然后重启容器：

docker-compose restart

启动后，在 JupyterLab 界面中：

• 切换主题：Settings → Theme → 选择你喜欢的主题（默认为 JupyterLab Dark）
• 切换语言：Settings → Language → 选择语言（默认为简体中文）

• jupyterlab-git：Git 版本控制
• jupyter-lsp：代码智能补全和检查（配合 python-lsp-server）
• jupyterlab-execute-time：单元格执行时间显示
• jupyter-resource-usage：系统资源监控
• jupyterlab-language-pack-zh-CN：中文语言包

主题使用 JupyterLab 内置的 Dark 主题，无需额外安装。