折根妙妙屋

1. Visual Studio 2022（IDE）≠ VS Code（编辑器）#

• VS Code：轻量编辑器，适合写脚本、看代码。但打不开 .sln 工程，无法直接编译 Windows DLL。
• Visual Studio 2022：完整的 C++ 集成开发环境，负责编译、链接、调试、内存检测。
• 你的选择：日常写代码可以在 VS Code，但编译和调试必须在 VS2022。

2. PCL（Point Cloud Library）#

• 点云处理的“OpenCV”，提供 pcl::PointCloud、pcl::VoxelGrid、pcl::ConvexHull 等组件。
• 安装后会有大量头文件和 .lib 文件，需要在 VS 的“项目属性”中配置包含目录和库目录。

3. TortoiseSVN + TortoiseMerge#

• TortoiseSVN：Windows 资源管理器右键直接操作 SVN（检出、更新、提交）。
• TortoiseMerge：解决代码冲突时的三路合并工具（左：你的代码 / 右：服务器代码 / 下：合并结果）。

1. 编译流程：代码如何变成可执行文件#

Python 是解释型，直接 python main.py 就跑。C++ 必须经历：

.cpp 源文件 → 编译器 → .obj 目标文件 → 链接器 → .exe / .dll

• 编译：检查语法，生成机器码（.obj）。
• 链接：把多个 .obj 和外部库（.lib）拼成最终文件。
• 你的动作：在 VS2022 里按 Ctrl + Shift + B（生成），就是在执行编译+链接。

2. 头文件（.h）与实现文件（.cpp）的分离#

Python 一个 .py 文件搞定所有。C++ 通常拆成两个文件：

为什么分离？

• 编译器需要知道“有哪些函数”，但不需要知道“函数怎么实现”就能编译其他文件。
• 主管调用你的 DLL 时，只需要你的 .h 头文件。

3. 内存管理：从“自动回收”到“自己负责”#

Python 中 numpy.zeros() 用完不用管。C++ 中：

血泪原则：写 PCL 代码时，永远用 ::Ptr，绝不写裸 new。

4. 命名空间（namespace）：避免名字撞车#

Python 用 import numpy as np 隔离。C++ 用 namespace：

1
namespace CarriageSegment {
2
    class Segmentor { ... };
3
} // 使用时：CarriageSegment::Segmentor seg;

1. 什么是 DLL（Dynamic Link Library）#

• 把算法打包成 .dll + .lib + .h，主管看不到源码，只能调用接口。
• 更新算法时，替换 .dll 即可，主程序无需重新编译。

2. 接口设计原则#

1. 只暴露标准类型：用 std::string、std::vector、float，不暴露 PCL 类型。
2. 类封装：Initialize → Process → Release 三段式生命周期。
3. C++ 名称修饰（mangling）：用 extern "C" 或统一宏，防止编译后函数名被改写。

3. 核心宏：__declspec(dllexport/dllimport)#

1
#ifdef CARRIAGE_EXPORTS
2
    #define CARRIAGE_API __declspec(dllexport)  // 编译 DLL 时导出
3
#else
4
    #define CARRIAGE_API __declspec(dllimport)  // 主管使用时导入
5
#endif

4. 完整接口代码（可直接复制）#

carriage_api.h

1
#pragma once
2
#include <string>
3
#include <vector>
4

5
#ifdef CARRIAGE_EXPORTS
6
    #define CARRIAGE_API __declspec(dllexport)
7
#else
8
    #define CARRIAGE_API __declspec(dllimport)
9
#endif
10

11
namespace CarriageSegment {
12

13
struct Point3D {
14
    float x = 0.0f;
15
    float y = 0.0f;
16
    float z = 0.0f;
17
};
18

19
struct CarriageInfo {
20
    float volume_m3 = 0.0f;      // 体积（立方米）
21
    bool success = false;        // 是否成功
22
    std::string error_msg;       // 错误信息
23
};
24

25
class CARRIAGE_API Segmentor {
26
public:
27
    bool Initialize(const std::string& config_path);
28
    CarriageInfo Process(const std::string& pcd_file_path);
29
    void Release();
30
};
31

32
} // namespace CarriageSegment

carriage_impl.cpp

1
#define CARRIAGE_EXPORTS  // 必须在 include 之前定义！
2
#include "carriage_api.h"
3
#include <iostream>
4

5
// 这里后续引入 PCL 头文件
6
// #include <pcl/io/pcd_io.h>
7
// #include <pcl/filters/voxel_grid.h>
8

9
namespace CarriageSegment {
10

11
bool Segmentor::Initialize(const std::string& config_path) {
12
    // TODO: 加载配置、初始化 PCL 对象
13
    std::cout << "[Init] Config: " << config_path << std::endl;
14
    return true;
15
}
16

17
CarriageInfo Segmentor::Process(const std::string& pcd_file_path) {
18
    CarriageInfo info;
19

20
    // TODO: 替换为真实 PCL 处理逻辑
21
    // 1. 加载 PCD
22
    // 2. 体素滤波
23
    // 3. 分割车厢
24
    // 4. 计算体积
25

26
    info.volume_m3 = 42.0f;  // 占位假数据
27
    info.success = true;
28
    return info;
29
}
30

31
void Segmentor::Release() {
32
    // TODO: 清理资源
33
    std::cout << "[Release] Resources cleaned." << std::endl;
34
}
35

36
} // namespace CarriageSegment

1. TortoiseSVN 核心操作（右键菜单）#

2. SVN 与 Git 的习惯差异#

1. 新增文件必须 Add：SVN 不会自动跟踪新 .cpp / .h，右键 → TortoiseSVN → 增加。
2. 提交前必须 Update：先拉最新代码，再提交，减少冲突。
3. 提交信息写清楚：

   1
   [车厢分割] 添加 DLL 接口头文件，定义 Segmentor 类
   2
   [车厢分割] 实现空壳 Process 函数，返回占位体积

3. TortoiseMerge 解决冲突#

1. 右键冲突文件 → TortoiseSVN → 编辑冲突。
2. 界面布局：
   • 左侧：你的本地修改（Working）
   • 右侧：服务器最新版本（Theirs）
   • 下方：合并结果（Merged），手动选择保留左/右。
3. 保存后，右键 → TortoiseSVN → 解决，标记冲突已处理。

1. 创建项目#

1
文件 → 新建 → 项目 → 搜索"动态链接库(DLL)"
2
→ 名称：CarriageSegment → 确定

2. 清理自动生成的无用文件#

删除：dllmain.cpp、framework.h、pch.cpp（如果不用预编译头）。

3. 添加你的文件#

右键项目 → 添加 → 新建项：

• carriage_api.h
• carriage_impl.cpp

4. 配置项目属性（关键）#

右键项目 → 属性：

1. 配置属性 → 常规 → 配置类型：确认是动态库(.dll)。
2. C/C++ → 预处理器 → 预处理器定义：添加 CARRIAGE_EXPORTS。
3. VC++ 目录 → 包含目录：添加 PCL 的 include 路径（如 C:\Program Files\PCL 1.13.1\include）。
4. VC++ 目录 → 库目录：添加 PCL 的 lib 路径。
5. 链接器 → 输入 → 附加依赖项：添加用到的 PCL .lib 文件（Release 模式）：

   1
   pcl_common.lib
   2
   pcl_io.lib
   3
   pcl_filters.lib
   4
   pcl_segmentation.lib
   5
   pcl_surface.lib

5. 编译与产出#

• 平台选 x64（不要 x86）。
• 按 Ctrl + Shift + B 生成。
• 产出在 x64\Release\：
  • CarriageSegment.dll → 运行时依赖
  • CarriageSegment.lib → 编译时链接
  • carriage_api.h → 给主管 include

1. VS 调试快捷键#

2. 内存泄漏检测#

在 main() 或测试程序中加入：

1
#define _CRTDBG_MAP_ALLOC
2
#include <crtdbg.h>
3

4
int main() {
5
    // ... 你的代码 ...
6
    _CrtDumpMemoryLeaks();  // 程序退出时打印泄漏报告
7
    return 0;
8
}

如果输出窗口显示 Detected memory leaks!，说明有 new 没 delete。

3. 常见编译错误#