Cover image for WSL2安装Ubuntu-20.04与配置

WSL2安装Ubuntu-20.04与配置

(Updated: )
Misc
,
时间轴

时间轴

2025-12-29

init

本文介绍了在WSL2环境中安装与配置Ubuntu-20.04的详细步骤，包括WSL实例的下载、迁移至D盘及用户权限恢复方法，并讨论了如何通过特定编译选项手动构建最新版Emacs，同时总结了更新gcc、QEMU、clangd、git、python及bear等开发工具与依赖的配置参考。

wsl下载ubuntu

1
2
3
4
# 查看可以下载的镜像
wsl --list --online
# 下载ubuntu20.04
wsl --install Ubuntu-20.04

迁移到D盘

在D盘创建一个目录用来存放新的WSL，比如D:\WSL\Ubuntu-20.04

1
2
3
4
5
6
7
# 1. 导出它的备份（比如命名为Ubuntu.tar)
wsl --export Ubuntu-20.04 D:\WSL\Ubuntu-20.04.tar
# 2. 注销原来的
wsl --unregister Ubuntu-20.04
# 3. 将备份文件恢复到D:\WSL\Ubuntu-20.04中去
wsl --import Ubuntu-20.04 D:\WSL\Ubuntu-20.04 D:\WSL\Ubuntu-20.04.tar
# 这时候可以把Ubuntu-20.04.tar删除了

如果这时候启动WSL，发现好像已经恢复正常了，但是用户变成了root。用以下命令恢复：

1
Ubuntu2004 config --default-user username

安装最新版emacs

可以安装较新的 gcc 编译器

1
2
3
4
5
6
7
8
9
10
11
12
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt update

sudo apt install gcc-13 g++-13

sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 90
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-9 90
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-13 130
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-13 130

# 之后如果要更改使用下面的命令
sudo update-alternatives --config gcc

编译 emacs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# Optional: 卸载snapd
sudo apt-get purge snapd
# 编译tree-sitter
git clone https://github.com/tree-sitter/tree-sitter.git
cd tree-sitter
git checkout release-0.25
make
make install PREFIX="$(pwd)/_install"
# 修复 .pc 文件中的 prefix
emacs _install/lib/pkgconfig/tree-sitter.pc
prefix=/home/zhaohang/repository/tree-sitter/_install

# 设置环境变量~/.bashrc或~/.zshrc
export PKG_CONFIG_PATH="$HOME/repository/tree-sitter/_install/lib/pkgconfig:$PKG_CONFIG_PATH"

# 下载emacs源码
wget https://mirrors.ustc.edu.cn/gnu/emacs/emacs-30.2.tar.xz
cd emacs-30.2
sudo apt install cmake build-essential
sudo apt install zlib1g-dev pkg-config libgnutls28-dev libncurses-dev libjansson-dev libvterm-dev libgccjit-$(gcc -dumpversion)-dev


export LD_LIBRARY_PATH="$HOME/repository/tree-sitter/_install/lib:$LD_LIBRARY_PATH"

./configure \
    --without-x \
    --without-ns \
    --without-pgtk \
    --with-native-compilation \
    --with-modules \
    --with-threads \
    --with-tree-sitter \
    --prefix=/usr/local \
    LDFLAGS="-Wl,-rpath,$LD_LIBRARY_PATH -L$LD_LIBRARY_PATH"

make -j$(nproc)
sudo make install
# 编译后测试，应该输出：RUNPATH /home/zhaohang/repository/tree-sitter/_install/lib：
objdump -p /usr/local/bin/emacs | grep RUNPATH
  • --without-xemacs-nox，不使用 X11（Xorg），只能用 emacs -nw（终端）
  • --without-ns禁用 macOS 的 Cocoa / NS 窗口系统，只是防止 configure 自动探测到 macOS GUI
  • --without-pgtk禁用 Pure GTK（Wayland 下的新 GUI 后端）
  • --with-native-compilation启用 native-comp（.eln）将Elisp 编译成机器码
  • --with-modules启用动态模块支持, 需要 libjansson-dev
  • --with-threads启用 多线程支持
  • --with-tree-sitter启用tree-sitter
  • --prefix=/usr/local安装到 /usr/local

emacs配置参考：

我的Emacs配置

https://even629.com/posts/28521

qemu 最新版编译参考

Qemu编译

https://even629.com/posts/2511219

另外通过apt下载的clangd版本比较老，可能不支持某些配置项，可通过下面命令安装较新的版本

1
2
3
4
5
6
7
8
9
10
11
12
wget https://apt.llvm.org/llvm.sh
chmod u+x llvm.sh
sudo ./llvm.sh 21
sudo apt-get install clang-format-21

# 安装 clang 到 alternatives 系统
sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-21 100
sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/bin/clang++-21 100
sudo update-alternatives --install /usr/bin/clangd clangd /usr/bin/clangd-21 100
sudo update-alternatives --install /usr/bin/clang-format clang-format /usr/bin/clang-format-21 100
# 安装 libstdc++-10
sudo apt install libstdc++-$(gcc -dumpversion)-dev

git 版本比较低，不支持-b参数，可以添加apt源更新

1
2
3
4
sudo add-apt-repository ppa:git-core/ppa -y
sudo apt update
sudo apt upgrade
sudo apt install git -y

python 版本是3.8某些软件可能依赖3.9及以上的版本：

1
2
3
4
5
6
7
8
9
10
11
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get update
sudo apt-get install python3.9 python3-pip

# 注册 python3.9，优先级设置为1
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.9 1
# 注册 python3.8，优先级设置为2，这样优先级大于python3.9
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 2

# 选择默认版本
sudo update-alternatives --config python3

bear 也可以使用最新版本，旧版本的bear是python脚本，效率偏低，而新版本是rust编写的二进制文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 下载rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# cargo 换源 visit https://mirrors.tuna.tsinghua.edu.cn/help/crates.io-index.git/
rustup update
# 编译bear
git clone https://github.com/rizsotto/Bear.git
cd bear
cargo build --release

sudo install -m 755 target/release/bear /usr/local/bin/
# For Debian based systems
export INSTALL_LIBDIR=lib/x86_64-linux-gnu
sudo mkdir -p /usr/local/libexec/bear/$INSTALL_LIBDIR
sudo install -m 755 target/release/libexec.so /usr/local/libexec/bear/$INSTALL_LIBDIR/

WSL2 Ubuntu20.04
WSL2 Ubuntu20.04

参考

[1]
Install Ubuntu on WSL 2
[2]
轻松搬迁！教你如何将WSL从C盘迁移到其他盘区，释放存储空间！
[3]
treesit-install-language-grammar warning