[环境配置]VSCode配置SourceMod编译方法

一、文件获取

1.下载地址

名称	地址
Visual Studio Code	https://code.visualstudio.com/
Sourcemod与Metamod	教程及下载地址
SPCOMP compile.exe	编译器参数说明

2.文件安装

1.Visual Studio Code 选择安装路径，此处与正常软件安装相同。
2.SourceMod只需要下载稳定的最新版本压缩包。

提取路径中addons\sourcemod\scripting\
文件夹:include
文件:compile.exe 与 spcomp.exe

本文章例子:
1.在D盘新建一个文件夹SP\SM
2.将提取的文件放到D:\SP\SM目录下

二、VS配置文件

1.中文界面

快捷键:Ctrl+Shift+X,在搜索框中输入:chinese,选择简体中文安装.

2.安装SourcePawn

快捷键:Ctrl+Shift+X,在搜索框中输入:SourcePawn,有多个版本可以供选择,我这里选择的是最近更新的版本

3.配置工作区(嫌麻烦可跳到操作步骤4.2,不影响插件编译)

1.文件 - 将工作区另存为…

这里保存文件名为SP,保存后才会出现SP.code-workspace.
2.文件 - 从文件打开工作区… - 选择:SP.code-workspace
3.文件 - 首选项 - 键盘快捷方式(快捷键:Ctrl+S)

在搜索框中输入:workbench.action.tasks.build

点击 笔 标志,设置快捷键,本例设置的F5键

4.1配置任务(配置编译器)

1.终端 - 配置任务 - 使用模板创建tasks.json文件 - Others 运行任意外部命令的示例

选择[使用模板创建 tasks.json 文件]

选择[Others 运行任意外部命令的实例]

tasks.json	//这是生成的默认文件内容
{
    // See https://go.microsoft.com/fwlink/?LinkId=733558
    // for the documentation about the tasks.json format
    "version": "2.0.0",
    "tasks": [
        {
            "label": "echo",
            "type": "shell",
            "command": "echo Hello"
        }
    ]
}

替换成下列代码

{
    "version": "2.0.0",
    "tasks": 
    [
        {
            "label": "编译SP",
            "type": "shell",
            "args": 
            [
                "${file}"	//当前打开的文件,保存在compiled目录下
            ],
            "windows": 
            {
                "command": "${workspaceRoot}\\SM\\compile.exe"  //执行compile.exe编译器,${workspaceRoot}工作区路径
            },
            "problemMatcher": [],
            "group": 
            {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

${workspaceFolder} - 在VS Code中打开的文件夹的路径
${workspaceFolderBasename} - VS Code中打开的文件夹名称，不带任何斜杠（/）
${file} - 当前打开的文件
${relativeFile} - 当前打开的相对于workspaceFolder的文件
${relativeFileDirname} - 当前打开文件的目录名（相对于workspaceFolder）
${fileBasename} - 当前打开的文件的基本名称
${fileBasenameNoExtension} - 当前打开的文件基本名称，不带文件扩展名
${fileDirname} - 当前打开的文件的目录名
${fileExtname} - 当前打开文件的扩展名
${cwd} - 启动时任务运行程序的当前工作目录
${lineNumber} - 活动文件中当前选择的行号
${selectedText} - 活动文件中当前选定的文本
${execPath} - VS Code可执行文件的路径
${defaultBuildTask} - 默认构建任务的名称

4.2 配置SOURCEPAWN

在扩展SourcePawn上鼠标右键 - 扩展设置

• Sourcepawn: Output Directory Path
  编译后的 .smx 文件的输出目录路径。以 / 结尾。
  
• Source Pawn Language Server: Spcomp Path
  SourceMod 编译器 (spcomp) 的位置
  

settings.json

{
    "SourcePawnLanguageServer.spcompPath": "D:\\SP\\SM\\spcomp.exe",
    "sourcepawn.outputDirectoryPath": "D:\\SP\\",
}

4.2.1设置编译快捷键

快捷键输入SM:compile file

三、测试SP编译

随便打开一个SP文件.查看右下角自动识别SourcePawn

快捷键快捷键:F5,下面提示表示编译成功

四、错误解决

1.Cannot read properties of undefined (reading ‘0’)

写入路径不存在