1634 字

8 分钟

项目开发随笔 v1.0

2026-03-06

/

随笔

1
Github仓库
2
https://github.com/Frees-Ling/Pipeline-inspection

一键安装Vscode Ubuntu#

1
sudo snap install code --classic

安装完Vscode之后一定一定要检查是否有自动保存，特别是针对项目级别工程文件，要不然你只能是对空文件编译

配置Git及密钥#

1
#配置Git用户信息
2
git config --global user.name "xxx"
3
git config --global user,email "xx@xx.com"
4
#配置密钥
5
ssh-keygen -t rsa -b 4096 -C "xx@xx.com"   #这里会生成密钥
6
cat ~/.ssh/id_rsa.pub #这里会输出密钥内容，把这个复制粘贴到代码平台的SSH配置里

配置密钥是为了更好的连接和传输代码（SSH）

1
#全部搞完之后，进行检查
2
ssh -T git@github.com  #后缀不唯一，这里以GitHub为例

Ubuntu20.04.x LTS 配置C/C++环境#

本教程仅供配置C/C++所用，主要用到的工具均为目前常用工具，需要完整的Ubuntu系统（不可以是试用版本）

1
#主要安装
2
clang
3
gdb
4
g++
5
gcc

1
#打开终端
2
sudo apt update
3
sudo apt install build-essential
4

5
#验证
6
gcc --version
7
g++ --version
8

9
#如果有版本号出现即为成功，可以进行下一步
10
sudo apt install gdb
11

12
#验证
13
gdb --version
14
#验证结果同上
15

16
sudo apt install clang
17
sudo apt install cmake
18
#这里如果出现无法安装，是因为软件源错误，解决方法如下
19
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak #备份
20
#换源
21
deb http://archive.ubuntu.com/ubuntu focal main restricted universe multiverse
22
deb http://archive.ubuntu.com/ubuntu focal-updates main restricted universe multiverse
23
deb http://archive.ubuntu.com/ubuntu focal-security main restricted universe multiverse
24
#随后执行如下命令
25
sudo apt update
26
sudo apt install clang
27

28
#验证
29
clang --version
30
cmake --version
31

32
#备用方案（可选）
33
sudo apt install build-essential clang gdb cmake ninja-build

ROS系统安装#

注意：
本次管道巡检所使用的ROS只能装在Ubuntu20.x上，Ubuntu22.x以上只能安装ROS2

1
#更新系统
2
sudo apt update
3
sudo apt upgrade
4

5
#安装工具链
6
sudo apt install curl gnupg lsb-release
7

8
#下载ROS公钥
9
sudo mkdir -p /usr/share/keyrings
10
curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc \
11
    | sudo gpg --dearmor -o /usr/share/keyrings/ros-archive-keyring.gpg
12

13
#添加ROS1 Noetic源
14
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] \
15
http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" \
16
| sudo tee /etc/apt/sources.list.d/ros-latest.list > /dev/null
17

18
#更新软件列表
19
sudo apt update
20

21
#进行安装
22
sudo apt install ros-noetic-desktop-full #完整版
23
sudo apt install ros-noetic-ros-base #核心版，仅有ROS
24

25
#配置环境变量
26
echo "source /opt/ros/noetic/setup.bash" >> ~/.bashrc
27
source ~/.bashrc
28

29
#安装依赖
30
sudo apt install python3-rosdep
31
sudo rosdep init
32
rosdep update
33

34
#分别开端口测试是否成功
35
roscore
36
rosrun turtlesim turtlesim_node

如下图即为成功

管道巡检代码复刻(足球无人机)#

如果只是简单的进行catkin make是不行的，会报如下错误

1
fl@fl-virtual-machine:~/桌面/Pipe/Pipeline-inspection$ catkin_make
2
Base path: /home/fl/桌面/Pipe/Pipeline-inspection
3
Source space: /home/fl/桌面/Pipe/Pipeline-inspection/src
4
Build space: /home/fl/桌面/Pipe/Pipeline-inspection/build
5
Devel space: /home/fl/桌面/Pipe/Pipeline-inspection/devel
6
Install space: /home/fl/桌面/Pipe/Pipeline-inspection/install
7
####
8
#### Running command: "cmake /home/fl/桌面/Pipe/Pipeline-inspection/src -DCATKIN_DEVEL_PREFIX=/home/fl/桌面/Pipe/Pipeline-inspection/devel -DCMAKE_INSTALL_PREFIX=/home/fl/桌面/Pipe/Pipeline-inspection/install -G Unix Makefiles" in "/home/fl/桌面/Pipe/Pipeline-inspection/build"
9
####
10
-- The C compiler identification is GNU 9.4.0
11
-- The CXX compiler identification is GNU 9.4.0
12
-- Check for working C compiler: /usr/bin/cc
13
-- Check for working C compiler: /usr/bin/cc -- works
14
-- Detecting C compiler ABI info
15
-- Detecting C compiler ABI info - done
16
-- Detecting C compile features
17
-- Detecting C compile features - done
18
-- Check for working CXX compiler: /usr/bin/c++
19
-- Check for working CXX compiler: /usr/bin/c++ -- works
20
-- Detecting CXX compiler ABI info
21
-- Detecting CXX compiler ABI info - done
22
-- Detecting CXX compile features
23
-- Detecting CXX compile features - done
24
-- Using CATKIN_DEVEL_PREFIX: /home/fl/桌面/Pipe/Pipeline-inspection/devel
25
-- Using CMAKE_PREFIX_PATH: /opt/ros/noetic
26
-- This workspace overlays: /opt/ros/noetic
27
-- Found PythonInterp: /usr/bin/python3 (found suitable version "3.8.10", minimum required is "3")
28
-- Using PYTHON_EXECUTABLE: /usr/bin/python3
29
-- Using Debian Python package layout
30
-- Found PY_em: /usr/lib/python3/dist-packages/em.py
31
-- Using empy: /usr/lib/python3/dist-packages/em.py
32
-- Using CATKIN_ENABLE_TESTING: ON
33
-- Call enable_testing()
34
-- Using CATKIN_TEST_RESULTS_DIR: /home/fl/桌面/Pipe/Pipeline-inspection/build/test_results
35
-- Forcing gtest/gmock from source, though one was otherwise available.
36
-- Found gtest sources under '/usr/src/googletest': gtests will be built
37
-- Found gmock sources under '/usr/src/googletest': gmock will be built
38
-- Found PythonInterp: /usr/bin/python3 (found version "3.8.10")
39
-- Found Threads: TRUE
40
-- Using Python nosetests: /usr/bin/nosetests3
41
-- catkin 0.8.12
42
-- BUILD_SHARED_LIBS is on
43
-- BUILD_SHARED_LIBS is on
44
-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
45
-- ~~  traversing 1 packages in topological order:
46
-- ~~  - rectangle
47
-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
48
-- +++ processing catkin package: 'rectangle'
49
-- ==> add_subdirectory(rectangle)
50
-- Could NOT find mavros (missing: mavros_DIR)
51
-- Could not find the required component 'mavros'. The following CMake error indicates that you either need to install the package with the same name or change your environment so that it can be found.
52
CMake Error at /opt/ros/noetic/share/catkin/cmake/catkinConfig.cmake:83 (find_package):
53
  Could not find a package configuration file provided by "mavros" with any
54
  of the following names:
55

56
    mavrosConfig.cmake
57
    mavros-config.cmake
58

59
  Add the installation prefix of "mavros" to CMAKE_PREFIX_PATH or set
60
  "mavros_DIR" to a directory containing one of the above files.  If "mavros"
61
  provides a separate development package or SDK, be sure it has been
62
  installed.
63
Call Stack (most recent call first):
64
  rectangle/CMakeLists.txt:10 (find_package)
65

66

67
-- Configuring incomplete, errors occurred!
68
See also "/home/fl/桌面/Pipe/Pipeline-inspection/build/CMakeFiles/CMakeOutput.log".
69
See also "/home/fl/桌面/Pipe/Pipeline-inspection/build/CMakeFiles/CMakeError.log".
70
Invoking "cmake" failed

那么错误报告很明显，缺失mavros这个包，我们需要进行安装如下是解决方案

1
# 更新软件源列表
2
sudo apt update
3

4
# 修复可能的依赖损坏
5
sudo apt --fix-missing install
6

7
# 安装 mavros 核心包
8
sudo apt install ros-noetic-mavros ros-noetic-mavros-extras
9

10
# 安装 mavros 的地理数据（用于 GPS 等功能，必须装）
11
wget https://raw.githubusercontent.com/mavlink/mavros/master/mavros/scripts/install_geographiclib_datasets.sh
12
chmod +x install_geographiclib_datasets.sh
13
sudo ./install_geographiclib_datasets.sh
14

15
# 删除临时脚本（可选）
16
rm install_geographiclib_datasets.sh
17

18
#如果报如下错误
19
fl@fl-virtual-machine:~/桌面/Pipe/Pipeline-inspection$ wget https://raw.githubusercontent.com/mavlink/mavros/master/mavros/scripts/install_geographiclib_datasets.sh
20
--2026-03-06 14:49:11--  https://raw.githubusercontent.com/mavlink/mavros/master/mavros/scripts/install_geographiclib_datasets.sh
21
正在解析主机 raw.githubusercontent.com (raw.githubusercontent.com)... 185.199.110.133, 185.199.109.133, 185.199.108.133, ...
22
正在连接 raw.githubusercontent.com (raw.githubusercontent.com)|185.199.110.133|:443... 已连接。
23
已发出 HTTP 请求，正在等待回应... 读取文件头错误 (连接被对方重设)。
24
重试中。
25

26
--2026-03-06 14:49:31--  (尝试次数： 2)  https://raw.githubusercontent.com/mavlink/mavros/master/mavros/scripts/install_geographiclib_datasets.sh
27
正在连接 raw.githubusercontent.com (raw.githubusercontent.com)|185.199.110.133|:443... 已连接。
28
已发出 HTTP 请求，正在等待回应... 读取文件头错误 (连接被对方重设)。
29
重试中。
30

31
--2026-03-06 14:49:53--  (尝试次数： 3)  https://raw.githubusercontent.com/mavlink/mavros/master/mavros/scripts/install_geographiclib_datasets.sh
32
正在连接 raw.githubusercontent.com (raw.githubusercontent.com)|185.199.110.133|:443...
33

34
#那么就是网络问题了
35

36
#如果下载失败，可进行如下操作
37
sudo apt install geographiclib-tools
38
sudo geographiclib-get-geoids egm96-15
39

40
#验证
41
# 查找 mavros 包的位置
42
rospack find mavros
43

44
# 预期输出（类似）：
45
# /opt/ros/noetic/share/mavros

那么解决了包缺失，我们可以很顺利地进行构建，如下为成功构建

1
fl@fl-virtual-machine:~/桌面/Pipe/Pipeline-inspection$ catkin_make
2
Base path: /home/fl/桌面/Pipe/Pipeline-inspection
3
Source space: /home/fl/桌面/Pipe/Pipeline-inspection/src
4
Build space: /home/fl/桌面/Pipe/Pipeline-inspection/build
5
Devel space: /home/fl/桌面/Pipe/Pipeline-inspection/devel
6
Install space: /home/fl/桌面/Pipe/Pipeline-inspection/install
7
####
8
#### Running command: "make cmake_check_build_system" in "/home/fl/桌面/Pipe/Pipeline-inspection/build"
9
####
10
####
11
#### Running command: "make -j8 -l8" in "/home/fl/桌面/Pipe/Pipeline-inspection/build"
12
####
13
Scanning dependencies of target mytest
14
Scanning dependencies of target detection
15
Scanning dependencies of target yaw_printer
16
Scanning dependencies of target cross_rectangle
17
[ 11%] Building CXX object rectangle/CMakeFiles/yaw_printer.dir/src/yaw_printer.cpp.o
18
[ 22%] Building CXX object rectangle/CMakeFiles/detection.dir/src/threshold_binary.cpp.o
19
[ 33%] Building CXX object rectangle/CMakeFiles/mytest.dir/src/test2.cpp.o
20
[ 44%] Building CXX object rectangle/CMakeFiles/cross_rectangle.dir/src/cross_rectangle.cpp.o
21
[ 55%] Building CXX object rectangle/CMakeFiles/cross_rectangle.dir/src/PID_controller.cpp.o
22
[100%] Linking CXX executable /home/fl/桌面/Pipe/Pipeline-inspection/devel/lib/rectangle/yaw_printer
23
[100%] Linking CXX executable /home/fl/桌面/Pipe/Pipeline-inspection/devel/lib/rectangle/cross_rectangle
24
[100%] Linking CXX executable /home/fl/桌面/Pipe/Pipeline-inspection/devel/lib/rectangle/mytest
25
[100%] Linking CXX executable /home/fl/桌面/Pipe/Pipeline-inspection/devel/lib/rectangle/detection
26
[100%] Built target yaw_printer
27
[100%] Built target mytest
28
[100%] Built target detection
29
[100%] Built target cross_rectangle

第三方库安装#

Eigen（线性代数库）#

1
sudo apt update
2
sudo apt install libeigen3-dev

安装完成后，头文件在 /usr/include/eigen3

OpenCV2#

1
sudo apt install libopencv-dev=2.4.9+dfsg-1

注意：Ubuntu 20.04 默认可能没有旧版 OpenCV2，需要自己编译，或者干脆用 OpenCV4，API 兼容性大部分没问题

OpenCV2 编译版#

1
sudo apt install build-essential cmake git libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev
2
git clone https://github.com/opencv/opencv.git
3
cd opencv
4
git checkout 2.4
5
mkdir build && cd build
6
cmake ..
7
make -j$(nproc)
8
sudo make install

安装完成后，头文件在 /usr/include/opencv 和 /usr/include/opencv2

国内

1
git clone https://gitee.com/OpenCVChina/opencv.git
2
cd opencv
3
git checkout 2.4
4
mkdir build
5
cd build
6
cmake ..
7
make -j$(nproc)
8
sudo make install```