第二章：环境搭建与配置

第二章：环境搭建与配置

"工欲善其事，必先利其器。"

一个良好的开发环境是高效工作的基础。本章将指导你完成Godot的安装配置，从基本的下载安装到高级的源码编译，从编辑器个性化设置到团队协作工作流。

2.1 系统要求

在下载Godot之前，让我们先确认你的计算机是否满足运行要求。

2.1.1 硬件配置要求

Godot以轻量著称，对硬件要求相当友好。以下是官方推荐的配置：

最低配置（运行编辑器）：

组件最低要求推荐配置
CPU双核处理器（SSE2支持）四核或更高
内存4GB RAM8GB RAM
显卡OpenGL 3.3 / Vulkan 1.0Vulkan 1.0 独立显卡
存储200MB（仅编辑器）2GB（含导出模板）

各架构支持：

架构WindowsmacOSLinux
x86_64✅✅✅
x86_32✅❌✅
ARM64✅✅ (Apple Silicon)✅
ARM32❌❌✅

2.1.2 操作系统支持

Windows：

  • Windows 10 或更高版本（推荐）
  • Windows 7/8/8.1（尽力支持，可能有限制）

macOS：

  • macOS 10.13 (High Sierra) 或更高版本
  • 完整支持 Apple Silicon (M1/M2/M3)

Linux：

  • 2018年后发布的主流发行版
  • 推荐：Ubuntu 20.04+、Fedora 36+、Arch Linux

2.1.3 开发工具准备

根据你的开发需求，可能需要安装以下工具：

基础开发（仅GDScript）：

  • 无需额外工具，Godot自带代码编辑器

C#开发：

  • .NET SDK 8.0 或更高版本
  • 推荐：Visual Studio Code + C# 扩展

外部代码编辑器（可选）：

  • Visual Studio Code
  • Sublime Text
  • Vim/Neovim

版本控制（强烈推荐）：

  • Git
  • GitHub Desktop / GitKraken（图形界面）

2.2 下载与安装

Godot的安装过程非常简单——下载、解压、运行，无需复杂的安装程序。

2.2.1 官方下载渠道

官方网站（推荐）：

https://godotengine.org/download

其他渠道：

渠道说明C#支持
官网最新版本，所有功能✅
Steam自动更新，方便管理❌
itch.io独立游戏平台❌
Epic Games StoreEpic平台❌
GitHub Releases源代码和预编译版本✅

⚠️ 注意：Steam、itch.io、Epic Games Store 版本不包含C#支持。如需使用C#，请从官网下载.NET版本。

版本选择：

版本文件名示例适用场景
标准版Godotv4.4-stablewin64.exe.zipGDScript开发
.NET版Godotv4.4-stablemono_win64.zipC#开发

2.2.2 Windows安装步骤

步骤1：下载

  1. 访问 https://godotengine.org/download/windows
  2. 选择适合你系统的版本（通常是 x86_64）
  3. 点击下载按钮

步骤2：解压

下载文件：Godot_v4.4-stable_win64.exe.zip
解压到：C:\Godot\ 或任意文件夹

步骤3：运行

  • 双击 Godotv4.4-stablewin64.exe
  • 首次运行可能需要允许Windows防火墙

可选：创建快捷方式

  • 右键单击exe文件
  • 选择"发送到" → "桌面快捷方式"

可选：添加到PATH

  1. 按 Win + X，选择"系统"
  2. 点击"高级系统设置"
  3. 点击"环境变量"
  4. 在"用户变量"中找到PATH
  5. 添加Godot所在目录

2.2.3 macOS安装步骤

步骤1：下载

  1. 访问 https://godotengine.org/download/macos
  2. 下载通用版（Universal，同时支持Intel和Apple Silicon）

步骤2：安装

# 解压下载的zip文件
unzip Godot_v4.4-stable_macos.universal.zip

# 移动到应用程序文件夹
mv Godot.app /Applications/

步骤3：首次运行

  • 由于Godot未经Apple公证，首次运行需要：
  • 右键点击Godot.app → 选择"打开"
  • 在弹出对话框中点击"打开"

Homebrew安装（替代方案）：

brew install --cask godot

2.2.4 Linux安装步骤

方法1：官网下载

# 下载
wget https://downloads.godotengine.org/4.4/stable/Godot_v4.4-stable_linux.x86_64.zip

# 解压
unzip Godot_v4.4-stable_linux.x86_64.zip

# 添加执行权限
chmod +x Godot_v4.4-stable_linux.x86_64

# 运行
./Godot_v4.4-stable_linux.x86_64

方法2：Flatpak（推荐）

# 安装 Flatpak（如未安装）
sudo apt install flatpak

# 添加 Flathub
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# 安装 Godot
flatpak install flathub org.godotengine.Godot

方法3：包管理器

# Ubuntu/Debian（可能版本较旧）
sudo apt install godot3

# Arch Linux
sudo pacman -S godot

# Fedora
sudo dnf install godot

2.2.5 移动端开发环境配置

如果你计划导出到Android或iOS，需要额外配置。

Android配置：

  1. 安装Android Studio

`` https://developer.android.com/studio ``

  1. 配置SDK

- 打开Android Studio → Configure → SDK Manager - 安装 Android SDK（API Level 33+推荐） - 安装 NDK (Side by side) - 安装 Android SDK Command-line Tools - 安装 CMake

  1. 创建Debug Keystore

``bash keytool -keyalg RSA -genkeypair -alias androiddebugkey \ -keypass android -keystore debug.keystore \ -storepass android -dname "CN=Android Debug,O=Android,C=US" \ -validity 9999 ``

  1. 在Godot中配置

- 编辑器 → 编辑器设置 → 导出 → Android - 设置 Android SDK 路径 - 设置 Debug Keystore 路径

iOS配置：

  • 需要macOS系统
  • 安装Xcode（App Store免费下载）
  • 需要Apple开发者账号（发布用）

2.3 从源码编译

对于想要修改引擎或使用最新开发版本的用户，可以从源码编译Godot。

2.3.1 开发环境搭建

所有平台通用：

  • Python 3.6+
  • SCons 4.0+
  • Git

Windows额外需求：

  • Visual Studio 2019/2022（含C++开发工具）
  • 或 MinGW-w64

macOS额外需求：

  • Xcode Command Line Tools

``bash xcode-select --install ``

Linux额外需求：

# Ubuntu/Debian
sudo apt install build-essential scons pkg-config libx11-dev \
  libxcursor-dev libxinerama-dev libgl1-mesa-dev libglu-dev \
  libasound2-dev libpulse-dev libudev-dev libxi-dev libxrandr-dev

# Fedora
sudo dnf install scons pkgconfig libX11-devel libXcursor-devel \
  libXrandr-devel libXinerama-devel libXi-devel mesa-libGL-devel \
  mesa-libGLU-devel alsa-lib-devel pulseaudio-libs-devel \
  libudev-devel gcc-c++

2.3.2 SCons构建系统

SCons是Godot使用的构建系统，基于Python。

安装SCons：

# pip方式（推荐）
pip install scons

# 或使用系统包管理器
# macOS
brew install scons

# Ubuntu
sudo apt install scons

验证安装：

scons --version
# 输出示例：SCons by Steven Knight et al.: ...

2.3.3 编译选项说明

获取源码：

git clone https://github.com/godotengine/godot.git
cd godot
git checkout 4.4-stable  # 切换到稳定版

基本编译命令：

# 编译编辑器（当前平台）
scons

# 指定平台
scons platform=windows  # Windows
scons platform=macos    # macOS
scons platform=linuxbsd # Linux

# 指定目标
scons target=editor           # 编辑器（默认）
scons target=template_debug   # 调试导出模板
scons target=template_release # 发布导出模板

常用选项：

选项说明示例
platform目标平台platform=windows
target构建目标target=editor
arch架构arch=x86_64
dev_build开发构建dev_build=yes
production生产构建production=yes
-j并行编译-j8

完整编译示例：

# Windows 64位编辑器，8线程编译
scons platform=windows arch=x86_64 target=editor -j8

# Linux发布模板
scons platform=linuxbsd target=template_release -j$(nproc)

# macOS通用二进制（Intel + Apple Silicon）
scons platform=macos arch=universal target=editor

2.3.4 编译常见问题解决

问题1：找不到编译器

解决：
- Windows: 使用Visual Studio开发者命令提示符
- Linux: 安装 build-essential 包
- macOS: 运行 xcode-select --install

问题2：缺少依赖

解决：根据错误信息安装对应的开发库
Linux示例：sudo apt install libxxx-dev

问题3：内存不足

解决：
- 减少并行编译数量：-j2
- 关闭其他程序
- 增加交换空间

问题4：编译中断后重新开始

# 清理后重新编译
scons --clean
scons platform=xxx -j8

2.4 编辑器设置

Godot编辑器提供了丰富的自定义选项，让你可以根据个人偏好调整工作环境。

2.4.1 界面主题设置

访问设置： 编辑器 → 编辑器设置 → 界面 → 主题

内置主题：

主题描述
Default默认深色主题
Light浅色主题
Breeze DarkKDE风格深色
Godot 2复古Godot 2风格
Gray灰色主题
Custom自定义颜色

调整界面缩放：

  • 编辑器设置 → 界面 → 编辑器 → 显示缩放
  • 对于高DPI显示器，可以设置为125%或150%

自定义字体：

  • 编辑器设置 → 界面 → 编辑器 → 主字体
  • 推荐等宽字体：JetBrains Mono、Fira Code、Source Code Pro

2.4.2 编辑器偏好设置

常用设置项：

设置路径说明推荐值
界面/编辑器/自动保存自动保存场景开启
界面/编辑器/保存时重新扫描修改后刷新文件系统开启
文件系统/目录/自动扫描项目路径启动时扫描项目开启
文本编辑器/行为/自动缩进代码自动缩进开启
文本编辑器/完成/自动显示自动补全开启

2.4.3 外部工具配置

配置外部代码编辑器：

编辑器 → 编辑器设置 → 文本编辑器 → 外部

  1. 勾选"使用外部编辑器"
  2. 设置可执行文件路径
  3. 设置执行参数

Visual Studio Code配置：

可执行文件路径：code（或完整路径）
执行参数：{project} --goto {file}:{line}:{col}

Sublime Text配置：

可执行文件路径：subl（或完整路径）
执行参数：{file}:{line}:{col}

Vim/Neovim配置：

可执行文件路径：nvim
执行参数：+{line} {file}

2.4.4 键盘快捷键自定义

访问快捷键设置： 编辑器 → 编辑器设置 → 快捷键

常用快捷键（可自定义）：

功能默认快捷键说明
保存场景Ctrl+S保存当前场景
运行项目F5运行主场景
运行当前场景F6运行当前编辑的场景
暂停游戏F7暂停运行中的游戏
停止游戏F8停止运行中的游戏
切换脚本编辑器Ctrl+Shift+X在2D/3D视图和脚本之间切换
快速打开脚本Ctrl+Shift+O打开脚本列表
搜索帮助F1搜索文档

2.4.5 代码编辑器设置

代码风格设置： 编辑器 → 编辑器设置 → 文本编辑器

设置推荐值说明
缩进/类型Tabs或Spaces根据团队规范
缩进/大小4GDScript标准
外观/显示行号开启便于定位
外观/显示缩进指南开启可视化缩进
外观/自动换行关闭保持代码可读
完成/代码补全延迟0.1-0.3秒根据偏好

2.5 首次启动与初始化

2.5.1 项目管理器界面

首次启动Godot时，你会看到项目管理器：

┌─────────────────────────────────────────────────┐
│  项目管理器                                      │
├─────────────────────────────────────────────────┤
│  [本地项目]  [资源库项目]                         │
├─────────────────────────────────────────────────┤
│  ┌─────────────────────────────────────────┐   │
│  │ 📁 MyGame                               │   │
│  │    路径: C:/Projects/MyGame             │   │
│  │    最后修改: 2024-01-13                 │   │
│  ├─────────────────────────────────────────┤   │
│  │ 📁 TestProject                          │   │
│  │    路径: C:/Projects/TestProject        │   │
│  └─────────────────────────────────────────┘   │
├─────────────────────────────────────────────────┤
│  [新建]  [导入]  [扫描]  [编辑]  [运行]          │
└─────────────────────────────────────────────────┘

主要功能：

按钮功能
新建创建新项目
导入导入现有项目
扫描扫描文件夹查找项目
编辑打开选中项目的编辑器
运行直接运行选中项目

2.5.2 创建第一个项目

步骤1：点击"新建"

步骤2：填写项目信息

项目名称：MyFirstGame
项目路径：C:/GodotProjects/MyFirstGame
渲染器：
  ○ Forward+ (高质量3D)
  ● Mobile (兼容性优先)
  ○ Compatibility (旧硬件)
版本控制：Git

渲染器选择指南：

渲染器适用场景特点
Forward+高品质3D游戏Vulkan，全特性
Mobile移动端、2D游戏Vulkan，性能优化
Compatibility旧设备、WebOpenGL，最大兼容

💡 提示：对于2D游戏或需要广泛兼容的项目，选择Mobile或Compatibility渲染器。

步骤3：点击"创建并编辑"

2.5.3 项目结构说明

创建项目后，文件夹结构如下：

MyFirstGame/
├── .godot/              # Godot缓存和导入文件（自动生成）
│   ├── editor/          # 编辑器状态
│   ├── imported/        # 导入的资源缓存
│   └── ...
├── project.godot        # 项目配置文件（必须）
└── icon.svg             # 默认项目图标

project.godot 文件：

[application]
config/name="MyFirstGame"
config/features=PackedStringArray("4.4", "Mobile")
config/icon="res://icon.svg"

[rendering]
renderer/rendering_method="mobile"

添加内容后的典型结构：

MyFirstGame/
├── .godot/
├── assets/              # 资源文件夹
│   ├── sprites/         # 精灵图片
│   ├── sounds/          # 音效
│   └── fonts/           # 字体
├── scenes/              # 场景文件夹
│   ├── main.tscn        # 主场景
│   ├── player.tscn      # 玩家场景
│   └── enemy.tscn       # 敌人场景
├── scripts/             # 脚本文件夹
│   ├── player.gd        # 玩家脚本
│   └── enemy.gd         # 敌人脚本
├── project.godot
└── icon.svg

2.6 工作流最佳实践

2.6.1 版本控制集成

为什么需要版本控制：

  • 追踪所有更改历史
  • 支持多人协作
  • 可以回退到任意版本
  • 备份和灾难恢复

Git基础设置：

# 初始化Git仓库
cd MyFirstGame
git init

# 创建 .gitignore

推荐的 .gitignore：

# Godot 4+ specific ignores
.godot/

# Godot-specific ignores
*.translation
export_presets.cfg

# Imported textures and samples
.import/

# Mono-specific ignores
.mono/
data_*/
mono_crash.*.json

# System/tool-specific ignores
.DS_Store
*.swp
*~

首次提交：

git add .
git commit -m "Initial project setup"

2.6.2 项目组织规范

推荐的文件夹结构：

project_root/
├── assets/                 # 所有资源文件
│   ├── art/
│   │   ├── sprites/       # 2D精灵
│   │   ├── textures/      # 3D纹理
│   │   └── ui/            # UI图片
│   ├── audio/
│   │   ├── music/         # 背景音乐
│   │   └── sfx/           # 音效
│   ├── fonts/             # 字体文件
│   └── models/            # 3D模型
├── scenes/                 # 场景文件
│   ├── levels/            # 关卡场景
│   ├── ui/                # UI场景
│   └── entities/          # 实体场景
├── scripts/                # 脚本文件
│   ├── autoload/          # 自动加载脚本
│   ├── resources/         # 自定义资源类
│   └── components/        # 组件脚本
├── addons/                 # 插件
└── project.godot

命名规范：

类型命名方式示例
文件夹snake_casegame_objects
场景文件snake_case.tscnplayer_character.tscn
脚本文件snake_case.gdplayer_controller.gd
类名PascalCasePlayerController
变量snake_caseplayer_speed
常量UPPER_SNAKEMAX_HEALTH
信号snake_casehealth_changed

2.6.3 协作开发配置

场景文件冲突处理：

Godot的场景文件（.tscn）是文本格式，支持Git合并，但复杂场景可能产生冲突。

最佳实践：

  1. 场景拆分：将大场景拆分为多个小场景
  2. 频繁提交：小步提交，减少冲突概率
  3. 沟通协调：避免同时编辑同一场景
  4. 使用分支：功能开发使用独立分支

团队开发设置：

# 克隆项目
git clone https://github.com/team/project.git

# 创建功能分支
git checkout -b feature/player-movement

# 开发完成后
git add .
git commit -m "Add player movement system"
git push origin feature/player-movement

# 创建Pull Request进行代码审查

编辑器设置同步：

可以通过版本控制共享部分编辑器设置：

  • project.godot - 项目配置
  • export_presets.cfg - 导出预设（可选共享）

本章小结

本章我们完成了Godot开发环境的搭建：

  1. 系统要求：Godot对硬件要求友好，支持Windows、macOS、Linux
  2. 下载安装：解压即用，无需复杂安装程序
  3. 源码编译：使用SCons构建系统，可自定义引擎
  4. 编辑器设置：主题、快捷键、外部编辑器等个性化配置
  5. 项目管理：理解项目结构和文件组织
  6. 工作流：Git版本控制和团队协作最佳实践

现在你已经有了一个完整的Godot开发环境。在下一章中，我们将深入探索Godot编辑器的每一个角落，全面了解其用户界面。

上一章：Godot引擎概述

下一章：用户界面详解

← 返回目录