Linux 開發環境設定大全：zsh、zinit、pyenv、poetry、docker

from Pixabay

最近為了升級 Ubuntu 版本，重建了工作上的 Linux VM（直接升級會怕），所以又得重新設定一次開發環境。

軟體界有一句名言叫「吃自己的狗糧」，通常指的是自己開發的工具，自己先使用。而每次重設 Linux 開發環境時，我也都在吃自己的狗糧——看自己寫的教學文章。

不誇張，就是一篇篇看，把指令複製貼上，一步一步將環境設定到位。

做了好幾次以後，這次不禁想到：「咦？我乾脆整理成一篇就好了啊！」

本文主旨

沒錯！本篇講述的是：當我拿到一個全新的 Linux VM，為了開發方便，一定會安裝、設定的工具——主要基於「Python 後端」角度。

內容參考自以往數篇文章，且只關注在建立開發環境的必要步驟，並適時給出一些額外的提醒與建議。

如此一來，我們就不必在文章間穿梭，力求節省時間、一步到位！

本文是以 Ubuntu 20.04 實作，如果你用的是別的 Linux 發行版，肯定會有一些差別，這部分還請留意。

話不多說，讓我們開始。

一、設定 SSH 連線

這部分我並沒有寫成文章，因為網路上的資源已經非常多，而且步驟也不算太複雜。

對我而言，主要設定下面兩種 SSH 連線：

本機電腦與遠端 VM 的連線。
VM 與 GitHub（或其它 Git 服務）的連線。

至於具體要怎麼做，還請自行 Google。

二、設定 zsh、zinit、Powerlevel10k

參考原文：

Ubuntu 安裝使用 zsh + 輕量級套件管理器 zinit

zsh 透過 zinit 安裝 Powerlevel10k 佈景主題

安裝 zsh

1
2
3

sudo apt-get update;
sudo apt-get upgrade -y;
sudo apt-get install -y zsh;

將 zsh 設為登入時的「預設」shell

1	sudo usermod -s /bin/zsh $USER

提醒：請務必先確認 zsh 本身的安裝、設定沒問題，可以正常使用。否則登入後可能直接卡住，需要透過別的帳號例如 admin 來處理。

新增`.zshrc`與`.zprofile`

1 2	touch .zshrc touch .zprofile

安裝 zinit 套件管理器

1	bash -c "$(curl --fail --show-error --silent --location https://raw.githubusercontent.com/zdharma-continuum/zinit/HEAD/scripts/install.sh)"

設定 zinit 套件

安裝完後，zinit 已經自動在.zshrc新增部分內容，請接著繼續新增下列內容：

# zsh 套件四天王
zinit light zsh-users/zsh-completions
zinit light zsh-users/zsh-autosuggestions
zinit light zsh-users/zsh-history-substring-search
zinit light zdharma-continuum/fast-syntax-highlighting

# Oh My Zsh 功能
zinit snippet OMZ::lib/completion.zsh
zinit snippet OMZ::lib/history.zsh
zinit snippet OMZ::lib/key-bindings.zsh
zinit snippet OMZ::lib/theme-and-appearance.zsh

# key binding
bindkey '^[[A' history-substring-search-up
bindkey '^[[B' history-substring-search-down
bindkey ',' autosuggest-accept

# 其他
zinit load djui/alias-tips

存檔後，重啟 shell。（如果要一併安裝 Powerlevel10k，可先不用重啟。）

安裝 Powerlevel10k 佈景主題

非常簡單，只要在 zinit 的設定內容後面，再加上這行即可：

1 2	# Powerlevel10k zinit ice depth=1; zinit light romkatv/powerlevel10k

存檔，重啟 shell，此時就會開始安裝 Powerlevel10k，隨即會進入「外觀樣式選擇與設定」畫面。

之後如果要重新設定，可使用指令p10k configure。

三、設定 pyenv

參考原文：Ubuntu 安裝使用 pyenv + pyenv-virtualenv

安裝 dependency

1
2

sudo apt-get update;
sudo apt-get install -y --no-install-recommends make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

安裝 pyenv

1	git clone https://github.com/pyenv/pyenv.git ~/.pyenv

設定 pyenv

這裡只講 zsh 的設定，bash 請參見原文。

`.zprofile`新增內容，使用`echo`指令，或自行貼上

直接使用echo指令：

1
2
3

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zprofile
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zprofile
echo 'eval "$(pyenv init --path)"' >> ~/.zprofile

或自行貼上.zprofile：

1
2
3

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"

`.zshrc`新增，一樣使用`echo`指令，或自行貼上

1	echo 'eval "$(pyenv init -)"' >> ~/.zshrc

1	eval "$(pyenv init -)"

pyenv 安裝 Python 3.10.10 並設為全域

1	pyenv install 3.10.10

通常需要等待好一段時間，安裝才會完成。🐸

接著透過 pyenv，將系統全域的 Python 設定為 3.10.10（或其他版本）：

1	pyenv global 3.10.10

不再安裝 pyenv-virtualenv

因為 Poetry 自帶了虛擬環境管理功能，容易和 pyenv-virtualenv 疊床架屋，徒增管理上的混淆，所以我現在一律只使用 Poetry + venv 來管理 Python 虛擬環境。

這也是我目前覺得最簡潔的做法。

四、設定 Poetry

參考原文：再見了 pip！最佳 Python 套件管理器——Poetry 完全入門指南

安裝 Poetry

1	curl -sSL https://install.python-poetry.org \| python3 -

新增`poetry`指令至 PATH

在.zshrc新增以下內容：

1	export PATH=$PATH:$HOME/.local/bin

修改`config`，改用專案內的`.venv`虛擬環境

1	poetry config virtualenvs.in-project true

五、安裝 Docker

安裝細節常常隨著 Docker 版本的更新而有所變動，建議直接看官方文件即可。

這次安裝有兩個發現：

最新版似乎已經不需要將使用者加入 Docker 群組了。
docker compose改以 plugin 的形式安裝，變成 Docker client 的子命令，而不再採用舊版的docker-compose。

文章目錄