使用VS + VS Code + Cocos2d-x写游戏

原创已于 2026-04-24 17:29:06 修改 · 612 阅读

10 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#cocos2d #游戏 #游戏引擎

于 2026-04-13 22:49:59 首次发布

笔记同时被 2 个专栏收录

56 篇文章

订阅专栏

第一次系列

10 篇文章

订阅专栏

Cocos2d-x是跨平台的2D游戏开发框架。
注意：必须用VS才能编译。

1 环境

1.1 Python 2.7

注意：必须下载Python2.7，3.x不行。
Python2.7下载地址，需要勾选Add python.exe to Path，否则需要在系统环境变量Path添加Python27和Python27\scripts路径。

在win+R -> cmd使用python --version命令检查。

1.2 MinGW-w64

这个之前已经装过了，这里不讲了。

1.3 CMake

CMake下载地址，选Windows x64 Installer。
在win+R -> cmd使用cmake --version检查。

1.4 Cocos2d-x

Cocos2d-x下载地址，下载源码，解压。
在解压后的文件夹项目根目录中，Shift+鼠标右键 -> 在此处打开终端。
在这里插入图片描述

python setup.py

提示输入NDK/Android SDK路径，直接回车跳过；提示“Add to PATH”，输入y回车；重启终端。

在win+R -> cmd使用cocos --version命令检查。

后续在命令行使用cocos命令都从这里打开终端。

1.5 VS Code

在VS Code装插件，关闭VS Code。
（1）C/C++
（2）CMake Tools
（3）CodeLLDB

创建项目

cocos new 项目名 -l cpp -d 存放路径

cocos new CardsGame -l cpp -d F:\workspace

用VS Code打开该项目的文件夹，将CMake Tools添加到工具栏。
在这里插入图片描述
选择GCC编译器，Debug模式，如下图左下角状态栏。

在当前页面按快捷键Ctrl+Shift+p，输入C/C++: Edit Configurations (UI)，在当前项目自动生成.vscode\c_cpp_properties.json文件。

1.6 VS2017

注意：只能下载2013、2015、2017
VS下载地址，只选“使用C++的桌面开发”并勾选左侧SDK即可。
在这里插入图片描述

2 编译

双击项目解决方案.\proj.win32\CardsGame.sln，用VS打开。一个解决方案包含四个项目，除了目标项目CardsGame，还包括lib开头的三个项目，这四个项目均需要 右键 -> 属性 ，检查SDK版本。
在这里插入图片描述
如下图，Windows SDK版本如果是8开头，要改为安装VS时勾选的以8开头的SDK版本，我这里是8.1；如果是10开头，要改为安装VS时勾选的以10开头的SDK版本，我这里是10.0.19041.0 ~~，原来默认的是10.0.17134.0~~ 。

四个项目都设置好后，关闭VS。

具体而言，四个项目是父子关系，缺一不可
libSpine（骨骼动画库）：做游戏任务动画、骨骼动画用的第三方库。
librecast（网络/通信库）：游戏联网、消息发送、网络同步用的第三方库。
libcocos2d（核心引擎）：整个Cocos2d-x引擎，画面、图片、声音等。
CardsGame：生成最终的.exe游戏文件。

在项目根目录文件夹打开终端，使用cocos命令编译。

cocos run -p win32

在这里插入图片描述

3 开发

项目结构如下：

CardsGame/
├── Classes/        ✅ 【这里放：所有 .h 和 .cpp】
│   ├── AppDelegate.h
│   ├── AppDelegate.cpp
│   ├── MainScene.h
│   ├── MainScene.cpp
│   ├── xxx.h
│   └── xxx.cpp
│
├── Resources/      ✅ 【这里放：图片、音效、字体】
│
└── proj.win32/     ✅ VS 工程文件夹

然后在VS里打开解决方案，在解决方案资源管理器中，右键src -> 添加 -> 现有项 ，将所有.cpp和.h都添加进来。

在VS菜单栏中找到 全部保存 ，即可使用cocos命令编译。之后每次修改后都要检查VS是否同步。

4 调试

点左侧Run and Debug，创建launch.json文件。
在这里插入图片描述
在弹出的选择框选择Windows调试器。

把program改成自己项目里.exe程序的路径，例如：

"program": "F:/workspace/CardsGame/bin/debug/win32/CardsGame.exe",

在需要调试的代码行打断点，然后F5即可运行。

5 导出

右键项目 -> 属性，左侧C/C++ -> 代码生成，将运行库改成多线程(/MT)。
在这里插入图片描述

在VS顶部工具栏，切换模式为Release。
在这里插入图片描述
右键项目 -> 生成，会在项目目录的proj.win32下生成一个Release.win32文件夹，压缩该文件夹。

其他人拿到压缩包后，可能会提示缺少某些.dll文件，我在自己电脑的"C:\Windows\SysWOW64"下找到相应的文件复制进去的。（游戏是win32需要从SysWOW64找，游戏是64位需要从system32下找）

*参考来源

Win10+Python2.7.14+cocos2d-x-3.17.2+VS2017环境搭建
 VsCode开发Cocos-lua,配置指南哦VsCode开发Cocos-lua,配置指南哦
 完整教程：Cursor/VSCode/VS2017 搭建Cocos2d-x环境，并进行正常的调试和运行（简单明了）