DevContainer 全栈远程开发环境

基于vscode-dev-containers构建的全栈远程开发环境，集成丰富的开发工具、多语言支持和实用程序，旨在为开发者提供开箱即用的高效远程开发体验。

核心功能和特性

Shell

• zsh：功能强大的命令行解释器
• oh-my-zsh：zsh配置管理框架
• git：分布式版本控制系统
• fzf：命令行模糊查找工具
• autojump：智能目录跳转工具，简化命令行导航
• zsh-autosuggestions：命令自动建议插件
• direnv：目录级环境变量自动管理工具

Vim 插件

• nerdtree：文件系统浏览器
• ctrlp.vim：模糊文件查找插件
• vim-easymotion：快速光标移动插件
• ag.vim：基于ag的代码搜索插件
• vim-airline：状态栏美化插件
• vim-airline-themes：状态栏主题集合
• vim-colors-solarized.git：Solarized颜色主题
• nerdcommenter：代码注释插件

Python 支持

• pyenv：Python版本管理工具

使用方法

# 查看可用Python版本
pyenv versions
# 切换Python版本
export PYENV_VERSION=3.10

# 创建并激活虚拟环境（使用链接的主版本）
mkvirtualenv -p /opt/pyenv/versions/3.10/bin/python hello-world
workon hello-world

环境配置

.envrc 文件：

layout virtualenvwrapper hello-world
unset PS1

.vscode/settings.json：

{
    "python.defaultInterpreterPath": "/root/.virtualenvs/hello-world/bin/python"
}

Golang 支持

• gvm：Golang版本管理工具

使用方法

# 查看可用Golang版本
gvm list
# 切换Golang版本
gvm use go1.17

环境配置

.envrc 文件：

layout gvm go1.17

.vscode/settings.json：

{
    "go.goroot": "/opt/gvm/gos/go1.17",
    "go.gopath": "/opt/gvm/pkgsets/go1.17/global"
}

Golang 私有模块设置

.vscode/settings.json：

{
    "go.goroot": "/opt/gvm/gos/go1.15",
    "go.gopath": "/opt/gvm/pkgsets/go1.15/global",
    "go.toolsEnvVars": {
        "GOPROXY": "[***]",
        "GOPRIVATE": "",
        "GONOSUMDB": "townsy.private-github.com"
    },
    "terminal.integrated.env.linux": {
        "GOPROXY": "[***]",
        "GOPRIVATE": "",
        "GONOSUMDB": "townsy.private-github.com"
    }
}

实用工具 (Utils)

• cloc：代码统计工具，支持多种编程语言
• restic：快速、安全、高效的备份程序
• rclone：云存储同步工具（类rsync）
• android-platform-tools：Android开发工具（adb、fastboot等）

配置 (Settings)

VSCode 扩展配置

{
    "remote.extensionKind": {
        "alefragnani.project-manager": ["workspace"]
    },
    "remote.SSH.defaultExtensions": [
        "ms-python.python",
        "ms-python.vscode-pylance",
        "golang.go",
        "TabNine.tabnine-vscode",
        "alefragnani.project-manager"
    ]
}

VSCode 远程SSH设置

~/.vscode-server/data/Machine/settings.json（使用链接的主版本）：

{
    "go.goroot": "/opt/gvm/gos/go1.17",
    "go.gopath": "/opt/gvm/pkgsets/go1.17/global",
    "go.toolsEnvVars": {
        "GOBIN": "/opt/go/bin"
    },
    "python.linting.flake8Path": "/usr/local/bin/flake8",
    "python.linting.flake8Args": ["--max-line-length=119"],
    "python.formatting.blackPath": "/usr/local/bin/black",
    "python.formatting.blackArgs": ["--line-length=119"],
    "python.sortImports.path": "/usr/local/bin/isort",
    "python.sortImports.args": ["--line-length=119"],
    "python.terminal.activateEnvironment": false,
    "git.ignoredRepositories": ["/opt/pyenv"],
    "projectManager.groupList": true,
    "projectManager.git.maxDepthRecursion": 4,
    "projectManager.git.baseFolders": ["/data/repos"]
}

提示与技巧 (Tips and Tricks)

Windows 远程SSH无法连接zsh

错误日志：

zsh: bad math expression: operand expected at `*100000 + ...'

解决方案：启用useLocalServer

{
    "remote.SSH.useLocalServer": true
}

可能存在非Windows SSH已安装问题，可忽略。

使用场景和适用范围

适用于全栈远程开发场景，尤其适合需要Python、Golang多语言开发，依赖高效命令行工具和编辑器配置的开发者。可通过VSCode Remote SSH等方式连接，提供预置的开发环境配置。

Docker部署示例

基本运行

docker run -it ifooth/devcontainer

结合VSCode Remote使用

1. 安装VSCode及Remote - SSH扩展
2. 通过SSH连接到运行该镜像的远程服务器
3. VSCode自动加载容器内的开发环境配置