Ubuntu System Setup - langningchen/miniapp GitHub Wiki

Ubuntu 系统配置

本指南帮助您配置 Ubuntu 系统，为编译 Miniapp 做好准备。适用于原生 Ubuntu 系统和 WSL2 中的 Ubuntu。

🎯 配置目标

更新系统包管理器
配置国内镜像源（解决网络慢的问题）
安装基础开发工具
设置 Git 配置

📋 开始之前

确保您已经：

✅ 安装了 Ubuntu 系统（或完成了 WSL 安装）
✅ 能够打开终端

🔧 系统更新和配置

步骤 1：打开终端

Ubuntu 桌面版：

按 Ctrl + Alt + T
或点击应用程序菜单 → 终端

WSL2：

在开始菜单搜索 "Ubuntu" 并打开
或在 PowerShell 中输入 wsl

步骤 2：更新包列表

# 更新包列表
sudo apt update

第一次运行时会询问密码，输入您的用户密码（输入时不显示字符）。

步骤 3：配置国内镜像源（可选但强烈推荐）

💡 为什么需要换源？ 国外镜像源在国内访问较慢，换成国内源可以大幅提升下载速度。

备份原始源列表：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup

选择合适的镜像源：

阿里云镜像（推荐）：

sudo sed -i 's@//.*archive.ubuntu.com@//mirrors.aliyun.com@g' /etc/apt/sources.list
sudo sed -i 's@//.*security.ubuntu.com@//mirrors.aliyun.com@g' /etc/apt/sources.list

清华大学镜像：

sudo sed -i 's@//.*archive.ubuntu.com@//mirrors.tuna.tsinghua.edu.cn@g' /etc/apt/sources.list
sudo sed -i 's@//.*security.ubuntu.com@//mirrors.tuna.tsinghua.edu.cn@g' /etc/apt/sources.list

中科大镜像：

sudo sed -i 's@//.*archive.ubuntu.com@//mirrors.ustc.edu.cn@g' /etc/apt/sources.list
sudo sed -i 's@//.*security.ubuntu.com@//mirrors.ustc.edu.cn@g' /etc/apt/sources.list

更新包列表：

sudo apt update

步骤 4：升级系统

# 升级已安装的包
sudo apt upgrade -y

这个过程可能需要几分钟，请耐心等待。

步骤 5：安装基础开发工具

# 安装编译和开发必需的工具
sudo apt install -y \
    build-essential \
    git \
    curl \
    wget \
    vim \
    unzip \
    tar \
    ca-certificates \
    gnupg \
    lsb-release

步骤 6：验证安装

检查工具是否正确安装：

# 检查 GCC 编译器
gcc --version

# 检查 Git
git --version

# 检查 Make
make --version

您应该看到类似输出：

gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0
git version 2.34.1
GNU Make 4.3

🌐 网络配置优化

配置 Git（必需）

# 设置 Git 用户信息（请替换为您的信息）
git config --global user.name "Your Name"
git config --global user.email "[email protected]"

# 验证配置
git config --list

配置代理（如果需要）

如果您使用代理上网：

# HTTP 代理（请替换为您的代理地址和端口）
export http_proxy=http://proxy.example.com:8080
export https_proxy=http://proxy.example.com:8080

# 或者 SOCKS5 代理
export http_proxy=socks5://127.0.0.1:1080
export https_proxy=socks5://127.0.0.1:1080

📁 创建工作目录

# 创建开发目录
mkdir -p ~/development
cd ~/development

# 验证当前目录
pwd

✅ 验证配置

运行以下命令确保一切正常：

# 测试网络连接
curl -I https://www.baidu.com

# 测试包管理器
sudo apt list --upgradable

# 测试 Git
git clone https://github.com/octocat/Hello-World.git test-repo
ls test-repo
rm -rf test-repo

🚀 下一步

系统配置完成后，请继续：

VSCode 开发环境配置 - 设置强大的代码编辑器
NodeJS 和 pnpm 安装指南 - 安装 JavaScript 运行环境

❗ 常见问题

问题1：sudo 命令要求密码

这是正常现象。输入您创建用户时设置的密码（输入时不显示字符）。

问题2：E: Unable to locate package

解决方案：

# 更新包列表
sudo apt update
# 然后重试安装命令

问题3：网络连接慢或失败

解决方案：

检查网络连接
尝试不同的镜像源
配置代理（如果需要）

问题4：磁盘空间不足

检查磁盘空间：

df -h

清理不需要的包：

sudo apt autoremove
sudo apt autoclean

问题5：WSL2 中访问 Windows 文件

WSL2 可以访问 Windows 文件系统：

# Windows C: 盘位于
cd /mnt/c/

# Windows 用户目录
cd /mnt/c/Users/YourUsername/

需要帮助？ 查看常见问题解决获取更多解决方案。