如何在其他程序中使用自定义函数及解决VSCode模块引用报错问题

其实按这几步操作就能轻松搞定：

• 先整理自定义函数的文件结构
  把函数的声明放在头文件（比如my_utils.h）里，具体实现放在对应的源文件（比如my_utils.c）中。举个例子：
  my_utils.h内容：

  #ifndef MY_UTILS_H
  #define MY_UTILS_H
  // 自定义函数声明
  int add_two_num(int a, int b);
  #endif
  

  my_utils.c内容：

  #include "my_utils.h"
  int add_two_num(int a, int b) {
      return a + b;
  }
  

• 在主程序中引入头文件
  要使用自定义函数的主程序（比如main.c）里，通过#include "my_utils.h"（或#include <my_utils.h>，后者需配置路径）引入头文件，之后直接调用函数即可：

  #include "my_utils.h"
  #include <stdio.h>
  int main() {
      printf("%d\n", add_two_num(3,5));
      return 0;
  }
  

• 编译时关联源文件
  编译阶段要把主程序和自定义函数的源文件一起编译，比如用GCC的命令：gcc main.c my_utils.c -o my_program，这样编译器才能找到函数的实现代码。

我之前踩过这个坑，给你几个实用的排查方向：

• 检查c_cpp_properties.json配置
  这个文件负责VSCode的语法检查和代码提示，你得确保includePath里确实添加了自定义模块所在的文件夹路径。比如你的头文件在./custom_modules目录下，配置应该像这样：

  {
      "configurations": [
          {
              "name": "Linux", // 根据你的系统选择Windows/macOS
              "includePath": [
                  "${workspaceFolder}/**",
                  "${workspaceFolder}/custom_modules" // 自定义模块的路径
              ],
              "compilerPath": "/usr/bin/gcc",
              "cStandard": "c17",
              "intelliSenseMode": "linux-gcc-x64"
          }
      ],
      "version": 4
  }
  

  配置完记得保存，路径可以用绝对路径或VSCode内置变量（比如${workspaceFolder}代表当前工作区根目录）。
• 区分#include <>和#include ""的差异
  编译器默认会优先在系统头文件目录查找<>里的文件，而""会先在当前目录和你配置的自定义路径里搜索。如果自定义模块不在系统路径中，试试把#include <my_module.h>改成#include "my_module.h"，很多时候这个小细节就能解决问题。
• 检查tasks.json的编译参数
  就算VSCode语法检查不报错了，编译时如果没指定头文件路径还是会失败。你需要在tasks.json的编译命令里加上-I参数指定头文件目录，比如GCC的编译任务：

  {
      "version": "2.0.0",
      "tasks": [
          {
              "label": "gcc build active file",
              "type": "shell",
              "command": "gcc",
              "args": [
                  "-g",
                  "${file}",
                  "-I", "${workspaceFolder}/custom_modules", // 指定头文件路径
                  "-o",
                  "${fileDirname}/${fileBasenameNoExtension}"
              ],
              "group": {"kind": "build", "isDefault": true},
              "problemMatcher": ["$gcc"]
          }
      ]
  }
  

• 核对路径和文件名的拼写
  别小看这个细节！有时候就是文件名大小写不一致（比如My_Module.h写成my_module.h），或者路径少写了一层目录，导致编译器找不到文件。仔细对比自定义模块的实际路径和配置里的路径是否完全匹配。

内容的提问来源于stack exchange，提问作者WildFire