ifooth/devcontainer

DevContainer 全栈远程开发环境

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

核心功能和特性

Shell

• https://www.zsh.org/：功能强大的命令行解释器
• https://github.com/ohmyzsh/ohmyzsh：zsh配置管理框架
• http://git-scm.com/：分布式版本控制系统
• https://github.com/junegunn/fzf：命令行模糊查找工具
• https://github.com/wting/autojump：智能目录跳转工具，简化命令行导航
• https://github.com/zsh-users/zsh-autosuggestions：命令自动建议插件
• https://github.com/direnv/direnv：目录级环境变量自动管理工具

Vim 插件

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

Python 支持

• https://github.com/pyenv/pyenv：Python版本管理工具

使用方法

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

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

环境配置

.envrc 文件：

bash
layout virtualenvwrapper hello-world
unset PS1

.vscode/settings.json：

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

Golang 支持

• https://github.com/moovweb/gvm：Golang版本管理工具

使用方法

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

环境配置

.envrc 文件：

bash
layout gvm go1.17

.vscode/settings.json：

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

Golang 私有模块设置

.vscode/settings.json：

json
{
    "go.goroot": "/opt/gvm/gos/go1.15",
    "go.gopath": "/opt/gvm/pkgsets/go1.15/global",
    "go.toolsEnvVars": {
        "GOPROXY": "https://athens-proxy.townsy.io,direct",
        "GOPRIVATE": "",
        "GONOSUMDB": "townsy.private-github.com"
    },
    "terminal.integrated.env.linux": {
        "GOPROXY": "https://athens-proxy.townsy.io,direct",
        "GOPRIVATE": "",
        "GONOSUMDB": "townsy.private-github.com"
    }
}

实用工具 (Utils)

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

配置 (Settings)

VSCode 扩展配置

json
{
    "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（使用链接的主版本）：

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

错误日志：

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

解决方案：启用useLocalServer

json
{
    "remote.SSH.useLocalServer": true
}

可能存在https://github.com/microsoft/vscode-remote-release/issues/2525问题，可忽略。

使用场景和适用范围

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

Docker部署示例

基本运行

shell
docker run -it docker.xuanyuan.run/ifooth/devcontainer

结合VSCode Remote使用

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