The Odin Project 开发环境搭建完整指南:从操作系统选型到 Google Chrome 安装
【免费下载链接】curriculumThe open curriculum for learning web development项目地址: https://gitcode.com/GitHub_Trending/cu/curriculum
本指南基于foundations/installations/installations.md课程文档,系统讲解在开始 The Odin Project 全栈开发课程之前,如何搭建一套真正可用的 Unix 系开发环境:包括受支持的操作系统范围、四种 Linux 环境方案(VirtualBox 虚拟机、双系统、ChromeOS、WSL2)的选型与关键安装步骤,以及课程唯一支持的浏览器 Google Chrome 的安装方式。学完本指南,你将能够独立判断自己当前环境是否受课程支持,并按照仓库内分步安装指南完成一套可长期用于编码、调试与测试的开发环境。
为什么需要先搭建真实的开发环境
构建任何网站的第一步,是拥有正确的工具——一套用于编写高质量代码的开发环境。许多在线课程使用浏览器内编辑器或“沙箱”,它们只提供完成任务所需的最小工具集,适合快速起步,但无法支撑长期学习。本课程在早期阶段也会用到部分沙箱,但真正能让学习者长期受益的方式,是在真实的开发环境中操作。
安装软件包、代码编辑器甚至整个操作系统(OS)的过程可能令人沮丧,但亲身体验配置一套能运行自己代码的开发环境,是一项会伴随整个职业生涯的宝贵技能。本文档对应源码位于 foundations/installations/installations.md。
跳过条件:如果你已经在使用 macOS、Ubuntu 或 Ubuntu 官方衍生版,且已安装 Google Chrome,可以直接跳过本课;否则请按下方说明搭建开发环境。
课程概览
本课的核心学习目标有两点:
- 如何搭建一套适合跟随 The Odin Project 课程的环境;
- 在你的环境中安装 Google Chrome。
受支持的操作系统
macOS
如果你使用 Mac,起点非常好:课程的所有指令都基于 Unix 系统设计,只需再安装几个程序即可开始学习。
Linux(Ubuntu 及官方衍生版)
Linux 是一款免费开源的操作系统,与几乎所有编程语言都能良好协作。大多数开发工具原生就是为 Linux 编写的,因此工具更新更频繁、可获得的排障资料更多、运行也更顺畅。为了提高社区互助的有效性,课程将受支持的 Linux 发行版限定为 Ubuntu 及 Ubuntu 官方衍生版,不支持任何其他发行版,包括“基于 Ubuntu 或 Debian”的发行版(如 Mint、Pop!_OS 等)。
课程支持以下三种运行 Linux 的方式,完整步骤见下文“动手实践”章节:
- VirtualBox 虚拟机(virtual machine)
- 双系统(dual-booting)
- Windows 子系统 for Linux 版本 2(WSL2)
Chromebook
Chromebook 用户可能可以在设备上运行 Linux 终端,具体细节见下文 ChromeOS Linux 指南。
为什么不原生支持 Windows
如果你没有 Apple 电脑,那么很可能正在使用 Windows。Windows 本身不被 The Odin Project 原生支持,也不在社区 Discord 服务器的支持范围内。原因是课程使用的许多工具都基于 Unix 环境编写,因此即使你未来打算把 Windows 作为开发系统,现阶段也仍然需要一个 Unix 系环境。
这并不意味着你必须抛弃 Windows:Linux 会愉快地与 Windows 共享硬盘。大多数面向普通用户的 OS 会隐藏或阻碍我们所需的语言与框架的使用,绕过这些障碍会让许多新手在旅程开始前就放弃。修改或双系统安装一台能配合所需工具的电脑,会显著降低编程起步难度,并营造一个无干扰的环境。Windows 用户可以从上述任一受支持方案中选择。
选择 Linux 的几大理由:
- 经过测试:课程团队已针对 macOS、Ubuntu(及官方衍生版)和 WSL2 验证过全部指引,尽量让你以最少问题装好工具。把时间耗在跟操作系统搏斗上,等于从学习编码的时间里偷走时间。
- 社区支持:使用课程推荐的工具组合,遇到问题时社区更容易提供帮助。
- 开发工具为 Linux 而生:Ruby (on Rails) 和 Node.js——本课程覆盖并被 web 开发社区广泛使用的两大后端技术——都是明确“期待”运行在开源(Unix 系)平台上的开源项目。
- 像专业人士一样工作:大量开发者使用 Unix 系操作系统。
- 性能:如果担心老旧机器性能与磁盘空间,Linux 是很好的选择——它比 Windows 占用更少的系统资源与硬盘空间。
仓库内还给出了明确的社区支持边界说明(installations.md):课程只能支持课程范围内的内容,不把原生 Windows 作为开发环境支持,也不建议在 Discord 中反复提出该诉求。
四种环境方案如何选
如果你当前不是 macOS、Ubuntu 或 Ubuntu 官方衍生版用户,就需要搭建一套开发环境。仓库提供了四种方案,各有优劣。
VirtualBox 虚拟机(推荐)
虚拟机(VM)是在你现有操作系统内部运行的整机模拟,例如在 Windows 中运行 Linux。虚拟机安装起来和普通程序一样直接、无风险;不喜欢随时可以移除,是新手快速起步的绝佳方式。正因如此,课程向初学者(尤其是不确定选哪种方案的用户)推荐虚拟机,并提供了非常清晰的分步指引。其唯一明显缺点是速度:你同时运行着两台电脑,可能偏慢——仓库指南中会给出多项性能优化手段。
双系统
双系统是在一台电脑上安装两个操作系统,开机时选择启动 Linux 还是 Windows。相比虚拟机的优势是操作系统可以使用你电脑的全部资源,运行速度明显更快。代价是存在一定风险:你需要修改硬盘分区(除非有专供 Linux 的独立硬盘)。只要放慢节奏、严格跟随指引(不要混搭其他来源的教程),就完全可以安全完成。
ChromeOS / ChromeOS Flex
适用于拥有 Chromebook、或想在老硬件上安装 ChromeOS Flex 的用户。许多 Chromebook 内置 Linux 支持,且足够胜任开发工作。
WSL2(进阶)
WSL2 是一种特殊的虚拟机,可以在 Windows 内部直接运行 Linux。它功能强大,但对新手容易造成困惑:两个操作系统同时运行且缺乏视觉分隔,误操作对象系统的概率比 VirtualBox 虚拟机或双系统更高,因此被标记为进阶选项,不推荐给对 OS 了解不多的初学者。此外请务必注意:WSL2 不等于 WSL1,课程只支持 WSL2。
浏览器支持:只用 Google Chrome
课程只支持使用 Google Chrome。理由很明确:
- 课程的教学内容基于 Chrome 编写;
- Chrome 在开发者和消费者中占据压倒性多数,推荐是有意为之;
- Chrome 内置强大的开发者工具,整个课程都会用它来检查、调试和测试 Web 应用。
其他浏览器也有类似工具,但课程的说明文字和截图都以 Chrome 为准,因此无法为其他浏览器的差异问题提供支持。各系统的 Chrome 安装方式见下文。
动手实践:按方案完成环境安装
以下步骤对应仓库中的完整安装指南。只有当你当前不是使用 macOS、Ubuntu 或 Ubuntu 官方衍生版时,才需要执行第 1 步的操作系统安装;另外请注意,本课程只支持笔记本、台式机或受支持的 Chromebook,无法帮助在树莓派等设备上搭建环境。已具备受支持软硬件环境的学习者可直接跳到第 2 步安装 Chrome。
方案一:VirtualBox 虚拟机(推荐)
完整指南见 安装指南:虚拟机。核心流程如下。
Step 1:下载 VirtualBox 与 Xubuntu
- 下载 Oracle VirtualBox(开源免费,指南建议 Windows 宿主使用 7.2.4 版本)。
- 下载 Xubuntu 的
.iso镜像(约 4GB):Xubuntu 是与 Ubuntu 同底层、但桌面环境更省资源的轻量版,非常适合虚拟机;建议选择LTS 版本 24.04 (Noble Numbat),这是社区验证过、最可靠的版本。
Step 2:安装 VirtualBox 并创建虚拟机
- 安装 VirtualBox 时建议将可选的 Python Support 功能关闭(
Entire feature will be unavailable),这不是必需组件;若提示缺少 Microsoft Visual C++ 2019 Redistributable,先安装再重试。应用本体务必装在C:盘,以免出错。 - 新建虚拟机:命名为Xubuntu-TOP,在 ISO Image 中选择刚才下载的
.iso;务必取消勾选 “Proceed with Unattended Installation”,该功能不可用,否则无法控制安装过程(误启用就删除虚拟机重来)。 - 虚拟硬件(Specify virtual hardware):Base Memory 至少2048 MB,上限为物理内存的一半;例如 8GB(8192 MB)内存可分配至 4096 MB。Processors 设置为2 且不要更多,保持 Use EFI 未勾选。换算提示:1 GB = 1024 MB。
- 虚拟硬盘(Specify virtual hard disk):其余保持默认,Disk Size 至少 30GB(磁盘可日后移动或扩容)。
- 虚拟显存(Display 设置):在 Settings → Display 中开启3D Acceleration,并将Video Memory 拉到最大;有多个物理显示器还可增加 Virtual Monitors 数量。
Step 3:开始安装 Xubuntu
启动虚拟机进入 GRUB Boot Menu,选择默认的Try or Install Xubuntu。随后在 Live Desktop 中双击Install Xubuntu,依次完成:选择语言 → 选择键盘布局(可输入测试)→ 连接网络(选Use wired connection,VirtualBox 通过宿主网卡以有线方式联网)→ 选择Interactive installation→ 应用默认全选 → 勾选安装推荐的专有软件 → 选择Erase disk and install Xubuntu(该操作只作用于虚拟磁盘,不会触碰宿主硬盘)→ 创建账户并设置密码 → 选择时区 → 确认后点击Install等待完成 →Restart now重启进入登录界面。
Step 4:更新系统与安装 Guest Additions
安装完成后虚拟机可能仍卡顿、窗口偏小,原因是没有为虚拟“硬件”安装驱动,这正是Guest Additions的作用。先更新系统(在 Xubuntu 中按Win+T打开终端,以下命令逐条输入并回车):
sudo apt update第一条命令会提示输入密码,终端不会显示任何输入反馈,这是安全特性而非故障。更新完成后继续:
sudo apt upgrade出现提示时输入Y确认。注意sudo成功后有一段时间免密窗口,所以连续执行两条命令不会再次询问密码。接着安装构建辅助包:
sudo apt install build-essential dkms然后在 VM 顶部工具栏点击Devices → Insert Guest Additions CD image...,在文件管理器中把VBoxLinuxAdditions.run拖入终端(先输入sudo再拖入路径),回车执行;完成后重启(新快捷键sudo reboot)。重启后最大化窗口即可获得完整桌面体验,建议顺手在文件管理器中点三角按钮或执行sudo eject /dev/sr0弹出 Guest Additions 镜像。
在 VM 内工作的约定:从 Windows 浏览器中关闭 TOP 网站,改为在 VM 内打开——课程经常需要在教程与编码区、终端之间复制粘贴,跨 VM/Windows 切换会很不顺畅。后续所有课程任务都应尽量在 VM 内完成:在 Settings → User Interface 中开启顶部工具栏,可在 Devices 中启用Shared Clipboard(Bidirectional)以便双向复制(终端内粘贴用ctrl+shift+v),推荐 View → Full-screen Mode 全屏使用,并为提升性能关闭宿主机的无关程序。
常见问题与性能调优(完整清单见 virtual_machine.md):
- 启动黑屏:关闭 VM,在 Settings → Display 中取消勾选 3D Acceleration,并确保 Video Memory 至少 128MB。
- 性能:处理器保持 2 核、内存分配不超过物理内存一半且至少 2GB;无法分出 2GB 就考虑双系统。视频卡顿可拉满 Video Memory 或禁用 3D Acceleration。
- 留意 VM 窗口右下角图标:绿色乌龟图标表示 Hyper-V 已开启,会影响性能;应关闭 Hyper-V(同时完全关闭已安装的 WSL2),使其变为芯片加 V 的图标。
- 安全关机三种方式:VM 内 Whisker 菜单电源键关机;终端执行
poweroff;或 VM 文件菜单选择Send the shutdown signal。切勿直接关闭窗口“拔电源”,否则文件可能损坏。
方案二:Ubuntu / Windows 双系统
完整指南见 安装指南:双系统。流程概览:
- Step 0 - BitLocker:Windows Pro 等版本可能开启了 BitLocker 磁盘加密,会导致无法直接安装;如需在受加密的主盘上安装,按官方指引临时禁用 BitLocker(安装在未加密的独立分区/硬盘则无需处理)。
- Step 1 - 下载 Ubuntu:建议下载标准桌面版 Ubuntu 的64 位 LTS 24.04。
- Step 2 - 制作启动 U 盘:准备至少 12GB 的 U 盘(制作过程会清空 U 盘数据,先备份),按官方教程创建可启动 U 盘。
- Step 3 - 安装:插入 U 盘重启,从 U 盘引导(不同品牌按键不同,如 Dell 是开机按 F12)。在安装器中务必选择Install Ubuntu alongside Windows,并为 Ubuntu 分配30GB 或更多磁盘空间。
- Intel RST:若遇到要求禁用 Intel RST 的报错,可先让 Windows 强制进入安全模式、切换主板存储驱动后再安装。
方案三:ChromeOS / ChromeOS Flex
完整指南见 安装指南:ChromeOS。前提是拥有受支持的 Chromebook(官方 Chromebook 或 ChromeOS Flex Chromebook),并在系统设置中启用 Linux 终端。满足条件后,即可全程跟随 Linux 版课程指令学习。
方案四:WSL2(进阶)
完整指南见 安装指南:WSL2。适用于 Windows 10 2004 及以上(Build 19041+)与 Windows 11。注意:WSL2 是完整的 Linux 发行版,后续课程中凡是区分操作系统的指令,你都应遵循Linux 指令(除非该课有 WSL2 专属说明)。
以管理员身份打开 PowerShell,执行:
wsl --install重启电脑后按提示设置小写用户名与密码(密码同样无输入回显)。
Windows 10 用户建议安装Windows Terminal,并在其设置中将Default Profile 设为 Ubuntu。
通过 Windows Terminal、Ubuntu 应用或开始菜单搜索打开 WSL2。
重要提醒:终端提示符前不应出现
/mnt/c——那是 Windows 文件系统在 WSL2 中的挂载点,在其中随意操作可能产生意外后果。
安装 Google Chrome
因为课程基于 Chrome,Chrome/Chromium 也是开发者和消费者的主流选择,因此所有学习者都需要安装 Chrome,按操作系统选择对应指南:
Linux(虚拟机或双系统用户,非 WSL2):chrome/linux.md。在终端下载
.deb包并安装:wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb sudo apt install ./google-chrome-stable_current_amd64.deb安装完成后可从 Applications 菜单启动,或在终端输入
google-chrome启动;若想在启动 Chrome 后继续使用同一终端,用google-chrome &让其在后台运行。可忽略“Download is performed unsandboxed”之类的提示性信息。终端内复制粘贴请使用Ctrl+Shift+C/Ctrl+Shift+V。macOS:chrome/macos.md。访问 Chrome 下载页点击Download Chrome for Mac,打开
googlechrome.dmg后将 Chrome 图标拖入 Applications 文件夹,再把.dmg拖入废纸篓清理。WSL2:chrome/wsl2.md。WSL2 没有 GUI,因此直接为 Windows 安装 Chrome:下载并运行
ChromeSetup.exe,然后从开始菜单启动;后续课程会讲解如何在 WSL2 内用这个 Windows 版 Chrome 预览工作成果。
环境就绪后的下一步
操作系统与 Chrome 就绪后,课程接下来会引导你继续配置开发环境的其他核心组件,可参考仓库中的后续课程:
- 文本编辑器安装:text_editors.md(各系统指南位于 installation_guides/text_editors 目录下);
- Git 安装与配置:setting_up_git.md(各系统指南位于 installation_guides/git 目录下);
- 命令行基础:command_line_basics.md;
- Web 工作原理:how_does_the_web_work.md。
知识检测
以下是本课的关键问题,用于回顾核心要点(无需死记硬背,答不上来可回看上文对应小节):
- The Odin Project 支持哪些操作系统?
- The Odin Project 支持哪个浏览器?
【免费下载链接】curriculumThe open curriculum for learning web development项目地址: https://gitcode.com/GitHub_Trending/cu/curriculum
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考