我的开发环境配置 2026：把 dotfiles 当成一个软件项目来维护

一、总原则：配置是代码，不是手工艺品二、Shell：zsh + starship，别名只留高频的三、运行时版本：mise 一个工具管所有语言四、环境变量：direnv 按目录自动加载五、任务入口：just 替代散落的脚本六、编辑器：配置也要能版本化七、bootstrap.sh：新机器的唯一入口结语参考来源

1602 字

8 分钟

我的开发环境配置 2026：把 dotfiles 当成一个软件项目来维护

2026-09-11

后端

开发环境

/

dotfiles

/

Shell

/

效率工具

/

mise

/

Neovim

换电脑、重装系统、临时开一台云主机——每次遇到这种事，最烦的不是装软件，而是「我原来是怎么配的来着？」。真正省事的做法只有一个：把开发环境当成一个软件项目来维护——有版本控制、有依赖声明、有一键安装脚本、有 README。

这篇文章记录我 2026 年的配置思路和具体文件，重点在「可复现」，而不是「堆插件」。

一、总原则：配置是代码，不是手工艺品#

三条规则：

所有配置进 Git。包括 shell、编辑器、终端、Git 自身的配置。
安装过程脚本化。新机器上第一件事是 git clone + ./bootstrap.sh，而不是回忆「我上次装了什么」。
平台差异用条件分支，不用多份副本。同一个 .zshrc 在 macOS 和 Linux 上跑，靠 uname 判断分支。

目录结构大概是这样：

1
~/.dotfiles
2
├── bootstrap.sh          # 一键安装入口
3
├── install/
4
│   ├── brew.sh           # macOS: Homebrew 包
5
│   ├── apt.sh            # Linux: apt 包
6
│   └── links.sh          # 建符号链接
7
├── shell/
8
│   ├── .zshrc
9
│   └── aliases.zsh
10
├── config/
11
│   ├── starship.toml
12
│   ├── mise/config.toml
13
│   └── nvim/
14
└── git/.gitconfig

软链接这一步我推荐用 GNU Stow，它按目录结构自动建链接，比手写 ln -s 好维护：

1
# 把 shell/ 下的文件链接到 ~ 下，保持相对结构
2
stow --target="$HOME" --verbose shell git

如果不想引入额外依赖，用一段 shell 也能搞定，关键是幂等——重复执行不出错：

1
link() {
2
  local src="$1" dst="$2"
3
  mkdir -p "$(dirname "$dst")"
4
  # -n 避免把已有软链接当成目录，-f 覆盖旧链接
5
  ln -sfn "$src" "$dst"
6
}
7

8
link "$DOTFILES/shell/.zshrc"  "$HOME/.zshrc"
9
link "$DOTFILES/git/.gitconfig" "$HOME/.gitconfig"

二、Shell：zsh + starship，别名只留高频的#

我不再用 Oh My Zsh——启动慢、插件黑盒。现在是一个极简 .zshrc 加 Starship 做提示符。

1
autoload -Uz compinit && compinit -C   # -C 跳过安全检查，启动快一倍
2
setopt HIST_IGNORE_ALL_DUPS HIST_VERIFY SHARE_HISTORY
3
setopt AUTO_CD CORRECT
4

5
# 历史搜索与模糊查找
6
source /opt/homebrew/share/zsh-autosuggestions/zsh-autosuggestions.zsh
7
eval "$(starship init zsh)"
8
eval "$(zoxide init zsh)"
9
eval "$(mise activate zsh)"
10
eval "$(direnv hook zsh)"
11

12
bindkey '^f' fzf-file-widget   # Ctrl+F 模糊找文件

Starship 的好处是配置是纯 TOML，跨 shell 通用，而且天然会显示当前目录的语言版本、Git 分支和耗时：

1
add_newline = false
2

3
[cmd_duration]
4
min_time = 500          # 超过 500ms 才显示，减少噪音
5
show_milliseconds = true
6

7
[git_status]
8
disabled = false
9

10
[nodejs]
11
symbol = " "
12
format = "via [$symbol($version )]($style)"

别名我只留真正每天敲的，其余靠补全：

1
alias gs='git status -sb'
2
alias gp='git push'
3
alias ll='eza -lah --git'
4
alias cat='bat --style=plain'
5
alias lg='lazygit'

三、运行时版本：mise 一个工具管所有语言#

过去我用 nvm 管 Node、pyenv 管 Python、rbenv 管 Ruby，三套逻辑三套坑。2026 年的答案基本收敛到 mise（前身 rtx），一个工具统管所有语言运行时，配置是统一格式：

1
# ~/.config/mise/config.toml —— 全局默认
2
[tools]
3
node = "22"
4
python = "3.13"
5
go = "1.24"

项目里再放一个 .mise.toml，进入目录自动切换，不需要手动 nvm use：

1
# 项目根目录/.mise.toml
2
[tools]
3
node = "20.19.0"
4
pnpm = "10"
5

6
[env]
7
NODE_ENV = "development"
8

9
[tasks.dev]
10
run = "pnpm dev"
11

12
[tasks.test]
13
depends = ["lint"]
14
run = "pnpm vitest run"

1
mise install     # 安装 .mise.toml 里声明的所有版本
2
mise ls          # 查看当前生效的版本
3
mise run test    # 跑任务，替代 npm scripts 的层层转发

这里有个实实在在的收益：版本声明进了 Git，团队里所有人的 Node 版本一致，CI 里只要跑一句 mise install 就能复现本地环境，“在我机器上是好的” 少了一大半。

四、环境变量：direnv 按目录自动加载#

.env 文件最大的问题是容易被误提交。direnv 的思路是按目录自动注入环境变量，并且默认不信任任何新文件，必须手动 direnv allow 一次：

1
# 项目根目录/.envrc
2
export DATABASE_URL="postgres://localhost:5432/dev"
3
export API_KEY="dev-only-key"
4

5
# 复用 .env 但保持 git 忽略
6
dotenv_if_exists .env
7

8
# 复杂逻辑可以抽成脚本
9
PATH_add ./bin
10
layout node

关键安全点：把 .envrc 提交进仓库，但只放非敏感的开发默认值，真实密钥仍然通过 dotenv_if_exists 从被忽略的 .env 读取。这样 git clone 之后不需要问任何人要配置，也不会泄露密钥。

五、任务入口：just 替代散落的脚本#

每个项目都有一堆「怎么跑起来」的知识，散在 README、package.json、同事脑子里。just 用一个 Justfile 把它们收拢：

1
# Justfile
2
set dotenv-load
3

4
default:
5
    @just --list
6

7
dev:
8
    mise run dev
9

10
test *args:
11
    pnpm vitest run {{args}}
12

13
setup:
14
    mise install
15
    pnpm install --frozen-lockfile
16
    cp -n .env.example .env || true
17
    @echo "✅ 环境就绪，运行 just dev"

新同事入职的流程从「翻文档 + 问人」变成两条命令：

1
git clone git@github.com:team/project.git && cd project
2
just setup && just dev

六、编辑器：配置也要能版本化#

VS Code 我用 Settings Sync + 仓库内 .vscode/ 双轨：个人偏好走 Sync，项目约束走仓库——格式化器、推荐插件、调试配置都提交进 Git，保证团队一致：

1
{
2
  "editor.formatOnSave": true,
3
  "editor.codeActionsOnSave": { "source.fixAll.biome": "explicit" },
4
  "[typescript]": { "editor.defaultFormatter": "biomejs.biome" },
5
  "typescript.tsdk": "node_modules/typescript/lib"
6
}

1
// .vscode/extensions.json —— 打开项目时提示安装
2
{
3
  "recommendations": ["biomejs.biome", "vitest.explorer", "streetsidesoftware.code-spell-checker"]
4
}

Neovim 这边则完全走 Lua 配置，跟着 dotfiles 仓库走：

1
-- ~/.config/nvim/lua/options.lua
2
vim.opt.number = true
3
vim.opt.relativenumber = true      -- 相对行号，配合 5j / 3k 跳转
4
vim.opt.undofile = true            -- 重启后仍能撤销
5
vim.opt.swapfile = false
6
vim.g.mapleader = " "

七、bootstrap.sh：新机器的唯一入口#

所有上面的东西，最后收敛成一个脚本。它的价值在于可重复执行——已经装过的跳过，没装的补上：

1
#!/usr/bin/env bash
2
set -euo pipefail
3

4
DOTFILES="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
5

6
case "$(uname -s)" in
7
  Darwin) brew bundle --file="$DOTFILES/install/Brewfile" ;;
8
  Linux)  sudo apt-get install -y zsh git curl ripgrep fd-find jq tmux ;;
9
esac
10

11
# 链接配置文件
12
while IFS= read -r -d '' f; do
13
  rel="${f#"$DOTFILES"/}"          # 去掉前缀，得到相对路径
14
  link "$f" "$HOME/${rel#*/}"      # 剥掉第一层目录名再链接到 $HOME
15
done < <(find "$DOTFILES/shell" "$DOTFILES/git" -type f -print0)
16

17
# 安装运行时与全局工具
18
mise install
19
curl -sS https://starship.rs/install.sh | sh -s -- --yes
20

21
echo "🎉 完成，重启 shell 生效"