Mojo安装 #

一、系统要求 #

1.1 支持的操作系统 #

操作系统	版本要求	架构
Ubuntu Linux	20.04+	x86_64
macOS	12.0+	x86_64, Apple Silicon
Windows	10+	x86_64 (WSL2)

1.2 硬件要求 #

CPU：x86_64或ARM64处理器
内存：至少4GB RAM
存储：至少2GB可用空间

1.3 软件依赖 #

Python 3.8+
pip包管理器
curl或wget

二、安装Mojo SDK #

2.1 获取Modular账号 #

访问 Modular官网
点击"Get Started"注册账号
验证邮箱

2.2 安装modular命令行工具 #

Linux/macOS：

bash

curl https://get.modular.com | sh -

或使用wget：

bash

wget -qO- https://get.modular.com | sh -

2.3 登录Modular账号 #

bash

modular auth login

按提示输入邮箱和验证码完成登录。

2.4 安装Mojo SDK #

bash

modular install mojo

安装过程可能需要几分钟。

2.5 配置环境变量 #

将Mojo添加到PATH：

Bash (~/.bashrc)：

bash

echo 'export MODULAR_HOME="$HOME/.modular"' >> ~/.bashrc
echo 'export PATH="$MODULAR_HOME/pkg/packages.modular.com_mojo/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Zsh (~/.zshrc)：

zsh

echo 'export MODULAR_HOME="$HOME/.modular"' >> ~/.zshrc
echo 'export PATH="$MODULAR_HOME/pkg/packages.modular.com_mojo/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2.6 验证安装 #

bash

mojo --version

输出示例：

text

mojo 0.8.0 (e8b7e7b1)

三、Windows安装（WSL2） #

3.1 启用WSL2 #

powershell

wsl --install

3.2 安装Ubuntu #

powershell

wsl --install -d Ubuntu-22.04

3.3 在WSL2中安装Mojo #

进入WSL2后，按照Linux安装步骤操作：

bash

curl https://get.modular.com | sh -
modular auth login
modular install mojo

四、开发工具配置 #

4.1 VS Code扩展 #

安装VS Code
搜索并安装"Mojo"扩展
配置Mojo路径

settings.json：

json

{
    "mojo.executablePath": "/home/user/.modular/pkg/packages.modular.com_mojo/bin/mojo"
}

4.2 Vim/Neovim配置 #

安装Mojo语法高亮：

bash

mkdir -p ~/.vim/syntax
curl -o ~/.vim/syntax/mojo.vim https://raw.githubusercontent.com/modularml/mojo/main/tools/vim/mojo.vim

~/.vimrc：

vim

au BufRead,BufNewFile *.mojo set filetype=mojo

4.3 Jupyter Notebook支持 #

安装Mojo内核：

bash

pip install modular
modular install mojo-jupyter

启动Jupyter：

bash

jupyter notebook

选择Mojo内核创建笔记本。

五、包管理 #

5.1 创建项目 #

bash

mkdir my_mojo_project
cd my_mojo_project
mojo init

5.2 项目结构 #

text

my_mojo_project/
├── main.mojo
├── mojo.toml
└── src/
    └── lib.mojo

5.3 配置文件 (mojo.toml) #

toml

[project]
name = "my_mojo_project"
version = "0.1.0"
authors = ["Your Name <you@example.com>"]

[dependencies]

5.4 添加依赖 #

bash

mojo add package_name

5.5 构建项目 #

bash

mojo build

5.6 运行项目 #

bash

mojo run main.mojo

六、常见问题 #

6.1 命令找不到 #

问题： mojo: command not found

解决： 检查PATH配置

bash

echo $PATH

确保包含Mojo的bin目录。

6.2 认证失败 #

问题： Authentication failed

解决： 重新登录

bash

modular auth logout
modular auth login

6.3 版本冲突 #

问题： 版本不兼容

解决： 更新Mojo

bash

modular update mojo

6.4 权限问题 #

问题： Permission denied

解决： 修复权限

bash

sudo chown -R $USER:$USER ~/.modular

七、更新与卸载 #

7.1 更新Mojo #

bash

modular update mojo

7.2 卸载Mojo #

bash

modular uninstall mojo

7.3 完全清理 #

bash

rm -rf ~/.modular
rm -rf ~/.config/modular

八、安装验证 #

创建测试文件验证安装：

test.mojo：

mojo

def main():
    print("Mojo is working!")

main()

运行测试：

bash

mojo run test.mojo

输出：

text

Mojo is working!

九、总结 #

本章学习了：

Mojo的系统要求
modular命令行工具安装
Mojo SDK安装
环境变量配置
开发工具设置
包管理基础

下一章，我们将编写第一个Mojo程序：Hello World。