如何使用CocosCreator进行游戏开发中的代码编辑器配置与断点调试？
- 内容介绍
- 文章标签
- 相关推荐
本文共计2552个文字，预计阅读时间需要11分钟。
在偏好的设置面板中指定了默认的脚本编辑器，便于在资源管理器中双击脚本文件直接打开代码编辑器快速编辑代码。以下以Visual Studio Code为例，介绍如何配置开发环境。
1. 安装Visual Studio Code：访问官网（https://code.visualstudio.com/）下载并安装Visual Studio Code。
2. 安装Python扩展：在Visual Studio Code中打开扩展市场，搜索Python，并安装Python扩展。
3. 安装Node.js扩展：在扩展市场中搜索Node.js，并安装Node.js扩展。
4. 安装Git扩展（可选）：在扩展市场中搜索Git，并安装Git扩展。
5. 配置Python环境：在Visual Studio Code中打开命令面板（按F1或Ctrl+Shift+P），输入Python: Select Interpreter，选择一个Python解释器。
6. 配置Node.js环境：在命令面板中输入Node.js: Select Node.js，选择一个Node.js版本。
7. 配置Git环境（可选）：在命令面板中输入Git: Clone Repository，克隆一个Git仓库。
8. 创建项目：在Visual Studio Code中创建一个新文件，选择合适的文件类型（如Python、Node.js等），开始编写代码。
9. 保存项目：将项目保存到本地，方便后续修改和查看。
10. 运行代码：在Visual Studio Code中按F5或Ctrl+Alt+N运行代码。
通过以上步骤，您可以在Visual Studio Code中配置并使用开发环境，方便地编写和调试代码。
在偏好设置面板中指定了默认脚本编辑器，便可以在资源管理器中双击脚本文件打开代码编辑器快速编辑代码。本篇内容主要以 Visual Studio Code 为例介绍如何配置开发环境。
Visual Studio Code（以下简称 VS Code）是微软推出的轻量化跨平台 IDE，支持 Windows、Mac、Linux 平台，安装和配置非常简单。使用 VS Code 管理和编辑项目脚本代码，可以轻松实现语法高亮、智能代码提示、网页调试等功能。
安装 VS Code
前往 VS Code 的官方网站，点击首页的下载链接即可下载。
MacOS 用户解压下载包后双击Visual Studio Code即可运行。
Windows 用户下载后运行VSCodeUserSetup.exe按提示完成安装即可运行。
智能提示数据
Cocos Creator 3.x 在创建项目时，项目目录下会自动生成一个tsconfig.json文件，里面配置了一个代码提示用的目录文件路径，用 VS Code 打开项目编写代码时便会自动提示 Cocos Creator 引擎 API。若项目升级，引擎 API 也会自动更新。
启动 VS Code 后选择主菜单的File -> Open Folder...，在弹出的对话框中选择项目根目录，也就是assets、project.json所在的路径。然后新建一个脚本，或者打开原有的脚本进行编辑时，就会有语法提示了。
注意：当使用自定义引擎，或者切换使用内置引擎/自定义引擎时，若出现 API 智能提示不更新的情况，请执行以下步骤以获得最新的代码智能提示：
设置文件显示和搜索过滤
在 VS Code 的主菜单中选择文件（Windows）／Code（Mac）-> 首选项 -> 设置，或者选择左下角
中的Setting选项，这个操作会打开用户配置文件USER SETTINGS：
此时在上方的搜索框中输入exclude搜索，找到Files: Exclude和Search: Exclude模块：
然后点击添加模式补充以下内容中缺少的部分：
{ "files.exclude": { "**/.git": true, "**/.DS_Store": true, "**/*.meta": true, "library/": true, "local/": true, "temp/": true }, "search.exclude": { "**/node_modules": true, "**/bower_components": true, "build/": true, "temp/": true, "library/": true, "**/*.anim": true }}
以上字段将为 VS Code 设置搜索时排除的目录，以及在文件列表中隐藏的文件类型。由于build、temp、library都是编辑器运行时自动生成的路径，而且会包含我们写入的脚本内容，所以应该在搜索中排除。而assets目录下的每个文件都会生成一个.meta文件，一般来说我们不需要关心它的内容，只要让编辑器帮我们管理这些文件就可以了。
VS Code 扩展使用
Cocos Creator 在顶部菜单栏的开发者 -> VS Code 工作流中集成了添加编译任务和添加 Chrome Debug 配置功能，以便更好地辅助开发：
- 添加编译任务：用于在 VS Code 中触发 Creator 的脚本编译，详情请参考下文使用 VS Code 激活脚本编译部分的内容。
- 添加 Chrome Debug 配置：用于调试网页版游戏，详情请参考下文使用 VS Code 调试网页版游戏部分的内容。
使用 VS Code 激活脚本编译
使用外部脚本编辑器修改项目脚本后，需要返回 Cocos Creator 以触发脚本编译。 我们在 Creator 中提供了添加编译任务功能，通过一个预览服务器的 API 向特定地址发送请求来激活 Creator 的编译，这样在外部脚本编辑器修改了项目脚本后，执行编译任务便可触发脚本编译，不需要返回 Cocos Creator。
安装 cURL
首先需要确保操作系统中可以运行cURL 命令，如果在 Windows 操作系统的命令行中运行curl提示找不到命令，则需要先安装 curl 到操作系统：
- 前往cURL for Windows: a Windows Installer for the Web Transfer Tool
- 点击下图箭头所示的控件，完成人机身份验证（若无法正常显示控件，请科学上网）
- 点击curl-7.46.0-win64.exe开始下载并安装
安装时请使用默认设置，安装完成后可以打开一个命令行窗口，输入curl，如果提示curl: try 'curl --help' or 'curl --manual' for more information就表示安装成功了。
添加 VS Code 编译任务
要在 VS Code 中激活脚本编译，需要执行以下步骤：
然后选择输出类型：
这样之后在 VS Code 编辑脚本完成后，执行第 2 个步骤便可触发 Creator 的脚本编译，不需要返回 Creator。
VS Code 还可以为编译任务配置快捷键，在主菜单中选择文件（Windows）／Code（Mac）-> 首选项 -> 键盘快捷方式，或者选择左下角
中的键盘快捷方式选项，这个操作会打开快捷键配置文件。然后根据需要修改编译任务的快捷键，例如下图将其设置成了Cmd/Ctrl + Shift + B：
之后在 VS Code 中按下快捷键Cmd/Ctrl + Shift + B便会自动显示CocosCreator compile，不需要手动搜索。
更多关于 VS Code 中配置和执行任务的信息，请参考Integrate with External Tools via Tasks文档。
使用 VS Code 调试网页版游戏
VS Code 有着优秀的调试能力，我们可以直接在源码工程中调试网页版游戏程序。
首先需要安装：
- Chrome（谷歌浏览器）
- VS Code 插件：Debugger for Chrome点击 VS Code 左侧导航栏的扩展按钮打开扩展面板，在搜索框中输入Debugger for Chrome并点击安装。安装之后可能需要重启 VS Code 才能生效。
接下来在 Cocos Creator 顶部菜单栏中点击开发者 -> VS Code 工作流 -> 添加 Chrome Debug 配置，这个菜单命令会在项目文件夹下添加一个.vscode/launch.json文件作为调试器的配置：
之后便可以在 VS Code 中点击左侧栏的调试按钮打开调试面板，并在最上方的调试配置中选择Cocos Creator Launch Chrome against localhost，然后点击左侧绿色的开始按钮进行调试。
调试的时候依赖 Cocos Creator 编辑器内置的 Web 服务器，所以需要在编辑器启动状态下才能进行调试。如果编辑器预览游戏时使用的端口不是默认端口，则需要手动修改launch.json里的url字段，将正确的端口添加上去。
调试过程中可以在源码文件上直接下断点，进行监控，是比使用 Chrome 内置的 DevTools 调试更方便和友好的工作流程。
学习 VS Code 的使用方法
前往VS Code 官网文档，了解从编辑功能操作、个性化定制、语法高亮设置到插件扩展等各方面的使用方法。
本文共计2552个文字，预计阅读时间需要11分钟。
在偏好的设置面板中指定了默认的脚本编辑器，便于在资源管理器中双击脚本文件直接打开代码编辑器快速编辑代码。以下以Visual Studio Code为例，介绍如何配置开发环境。
1. 安装Visual Studio Code：访问官网（https://code.visualstudio.com/）下载并安装Visual Studio Code。
2. 安装Python扩展：在Visual Studio Code中打开扩展市场，搜索Python，并安装Python扩展。
3. 安装Node.js扩展：在扩展市场中搜索Node.js，并安装Node.js扩展。
4. 安装Git扩展（可选）：在扩展市场中搜索Git，并安装Git扩展。
5. 配置Python环境：在Visual Studio Code中打开命令面板（按F1或Ctrl+Shift+P），输入Python: Select Interpreter，选择一个Python解释器。
6. 配置Node.js环境：在命令面板中输入Node.js: Select Node.js，选择一个Node.js版本。
7. 配置Git环境（可选）：在命令面板中输入Git: Clone Repository，克隆一个Git仓库。
8. 创建项目：在Visual Studio Code中创建一个新文件，选择合适的文件类型（如Python、Node.js等），开始编写代码。
9. 保存项目：将项目保存到本地，方便后续修改和查看。
10. 运行代码：在Visual Studio Code中按F5或Ctrl+Alt+N运行代码。
通过以上步骤，您可以在Visual Studio Code中配置并使用开发环境，方便地编写和调试代码。
在偏好设置面板中指定了默认脚本编辑器，便可以在资源管理器中双击脚本文件打开代码编辑器快速编辑代码。本篇内容主要以 Visual Studio Code 为例介绍如何配置开发环境。
Visual Studio Code（以下简称 VS Code）是微软推出的轻量化跨平台 IDE，支持 Windows、Mac、Linux 平台，安装和配置非常简单。使用 VS Code 管理和编辑项目脚本代码，可以轻松实现语法高亮、智能代码提示、网页调试等功能。
安装 VS Code
前往 VS Code 的官方网站，点击首页的下载链接即可下载。
MacOS 用户解压下载包后双击Visual Studio Code即可运行。
Windows 用户下载后运行VSCodeUserSetup.exe按提示完成安装即可运行。
智能提示数据
Cocos Creator 3.x 在创建项目时，项目目录下会自动生成一个tsconfig.json文件，里面配置了一个代码提示用的目录文件路径，用 VS Code 打开项目编写代码时便会自动提示 Cocos Creator 引擎 API。若项目升级，引擎 API 也会自动更新。
启动 VS Code 后选择主菜单的File -> Open Folder...，在弹出的对话框中选择项目根目录，也就是assets、project.json所在的路径。然后新建一个脚本，或者打开原有的脚本进行编辑时，就会有语法提示了。
注意：当使用自定义引擎，或者切换使用内置引擎/自定义引擎时，若出现 API 智能提示不更新的情况，请执行以下步骤以获得最新的代码智能提示：
设置文件显示和搜索过滤
在 VS Code 的主菜单中选择文件（Windows）／Code（Mac）-> 首选项 -> 设置，或者选择左下角
中的Setting选项，这个操作会打开用户配置文件USER SETTINGS：
此时在上方的搜索框中输入exclude搜索，找到Files: Exclude和Search: Exclude模块：
然后点击添加模式补充以下内容中缺少的部分：
{ "files.exclude": { "**/.git": true, "**/.DS_Store": true, "**/*.meta": true, "library/": true, "local/": true, "temp/": true }, "search.exclude": { "**/node_modules": true, "**/bower_components": true, "build/": true, "temp/": true, "library/": true, "**/*.anim": true }}
以上字段将为 VS Code 设置搜索时排除的目录，以及在文件列表中隐藏的文件类型。由于build、temp、library都是编辑器运行时自动生成的路径，而且会包含我们写入的脚本内容，所以应该在搜索中排除。而assets目录下的每个文件都会生成一个.meta文件，一般来说我们不需要关心它的内容，只要让编辑器帮我们管理这些文件就可以了。
VS Code 扩展使用
Cocos Creator 在顶部菜单栏的开发者 -> VS Code 工作流中集成了添加编译任务和添加 Chrome Debug 配置功能，以便更好地辅助开发：
- 添加编译任务：用于在 VS Code 中触发 Creator 的脚本编译，详情请参考下文使用 VS Code 激活脚本编译部分的内容。
- 添加 Chrome Debug 配置：用于调试网页版游戏，详情请参考下文使用 VS Code 调试网页版游戏部分的内容。
使用 VS Code 激活脚本编译
使用外部脚本编辑器修改项目脚本后，需要返回 Cocos Creator 以触发脚本编译。 我们在 Creator 中提供了添加编译任务功能，通过一个预览服务器的 API 向特定地址发送请求来激活 Creator 的编译，这样在外部脚本编辑器修改了项目脚本后，执行编译任务便可触发脚本编译，不需要返回 Cocos Creator。
安装 cURL
首先需要确保操作系统中可以运行cURL 命令，如果在 Windows 操作系统的命令行中运行curl提示找不到命令，则需要先安装 curl 到操作系统：
- 前往cURL for Windows: a Windows Installer for the Web Transfer Tool
- 点击下图箭头所示的控件，完成人机身份验证（若无法正常显示控件，请科学上网）
- 点击curl-7.46.0-win64.exe开始下载并安装
安装时请使用默认设置，安装完成后可以打开一个命令行窗口，输入curl，如果提示curl: try 'curl --help' or 'curl --manual' for more information就表示安装成功了。
添加 VS Code 编译任务
要在 VS Code 中激活脚本编译，需要执行以下步骤：
然后选择输出类型：
这样之后在 VS Code 编辑脚本完成后，执行第 2 个步骤便可触发 Creator 的脚本编译，不需要返回 Creator。
VS Code 还可以为编译任务配置快捷键，在主菜单中选择文件（Windows）／Code（Mac）-> 首选项 -> 键盘快捷方式，或者选择左下角
中的键盘快捷方式选项，这个操作会打开快捷键配置文件。然后根据需要修改编译任务的快捷键，例如下图将其设置成了Cmd/Ctrl + Shift + B：
之后在 VS Code 中按下快捷键Cmd/Ctrl + Shift + B便会自动显示CocosCreator compile，不需要手动搜索。
更多关于 VS Code 中配置和执行任务的信息，请参考Integrate with External Tools via Tasks文档。
使用 VS Code 调试网页版游戏
VS Code 有着优秀的调试能力，我们可以直接在源码工程中调试网页版游戏程序。
首先需要安装：
- Chrome（谷歌浏览器）
- VS Code 插件：Debugger for Chrome点击 VS Code 左侧导航栏的扩展按钮打开扩展面板，在搜索框中输入Debugger for Chrome并点击安装。安装之后可能需要重启 VS Code 才能生效。
接下来在 Cocos Creator 顶部菜单栏中点击开发者 -> VS Code 工作流 -> 添加 Chrome Debug 配置，这个菜单命令会在项目文件夹下添加一个.vscode/launch.json文件作为调试器的配置：
之后便可以在 VS Code 中点击左侧栏的调试按钮打开调试面板，并在最上方的调试配置中选择Cocos Creator Launch Chrome against localhost，然后点击左侧绿色的开始按钮进行调试。
调试的时候依赖 Cocos Creator 编辑器内置的 Web 服务器，所以需要在编辑器启动状态下才能进行调试。如果编辑器预览游戏时使用的端口不是默认端口，则需要手动修改launch.json里的url字段，将正确的端口添加上去。
调试过程中可以在源码文件上直接下断点，进行监控，是比使用 Chrome 内置的 DevTools 调试更方便和友好的工作流程。
学习 VS Code 的使用方法
前往VS Code 官网文档，了解从编辑功能操作、个性化定制、语法高亮设置到插件扩展等各方面的使用方法。