Software-Engineering on Blog

cpp静态变量初始化

Tue, 28 Apr 2026 00:00:00 +0000

类的成员变量

外部

hpp里定义，然后cpp里初始化，这个是最常用的，就不列举了。

内联变量 inline

C++ 17 引入，使用 inline 关键字声明的变量可以在多个翻译单元中定义

可以直接写类里面，也可以在类外初始化。

class Example{
 inline static int a = 5;
};

或者

class Example{
 static int a;
};

inline int Example::a = 5;

以上两种方式主要是为了在头文件初始化变量。

PyThreadLock

Wed, 15 Apr 2026 10:30:52 +0800

RAII

import threading
lock = threading.Lock()

with lock:
 # ...
 pass

CppTemplate

Thu, 09 Apr 2026 15:11:35 +0800

避免嵌套

应当避免反复对模板函数进行嵌套

PyIssue

Wed, 01 Apr 2026 08:30:24 +0800

文件重名

给py文件起名需要非常谨慎重名会导致严重问题比如我给一个文件起名openai，但是有叫openai的包，或者其他包里面也有个叫这个的文件，就会导致引用错误

Traceback (most recent call last):
 File "~/src/chroma.py", line 5, in <module>
 openai_ef = embedding_functions.OpenAIEmbeddingFunction(
 api_key_env_var=KEY,
 api_base=BASE_URL,
 )
 File "~/python3/lib/python3.13/site-packages/chromadb/utils/embedding_functions/openai_embedding_function.py", line 47, in __init__
 import openai
 File "/www/qqbot/src/openai.py", line 28, in <module>
 ENDPOINT = os.environ["AI_ENDPOINT"]
 ~~~~~~~~~~^^^^^^^^^^^^^^^
 File "<frozen os>", line 717, in __getitem__
KeyError: 'AI_ENDPOINT'

虚函数与纯虚函数

Thu, 12 Mar 2026 19:37:40 +0800

定义一个函数为虚函数，不代表函数为不被实现的函数。定义他为虚函数是为了允许用基类的指针来调用子类的这个函数。定义一个函数为纯虚函数，才代表函数没有被实现。定义纯虚函数是为了实现一个接口，起到一个规范的作用，规范继承这个类的程序员必须实现这个函数。

纯虚函数

含有纯虚函数的类即为抽象类，不可实例化

virtual void funtion1()=0;

重写可以改变访问修饰。

纯虚函数在基类无所谓访问修饰，因为其在必须在子类定义(重写)。

CppModules

Sat, 14 Feb 2026 00:00:00 +0000

什么是模块

Cpp20新加的这个功能，更像是用于制作单个动态库，标注动态库的接口

简单示例

// math.cppm（模块接口文件）
export module math;
export int add(int a, int b) {
 return a + b;
}

// main.cpp
import math; // 只导入编译好的二进制接口
int main() {
 return add(1, 2);
}

示例：cpptrace模块

module;
#include <cpptrace/basic.hpp>
#include <cpptrace/cpptrace.hpp>
#include <cpptrace/exceptions.hpp>
#include <cpptrace/formatting.hpp>
#include <cpptrace/forward.hpp>
#include <cpptrace/from_current.hpp>

export module cpptrace;

CPPTRACE_BEGIN_NAMESPACE
 // cpptrace/basic
 export using cpptrace::raw_trace;
 export using cpptrace::object_frame;
 export using cpptrace::object_trace;
 export using cpptrace::nullable;
 export using cpptrace::stacktrace_frame;
 export using cpptrace::stacktrace;
 export using cpptrace::generate_raw_trace;
 export using cpptrace::generate_object_trace;
 export using cpptrace::generate_trace;
 export using cpptrace::safe_generate_raw_trace;
 export using cpptrace::safe_object_frame;
 export using cpptrace::can_get_safe_object_frame;
 export using cpptrace::can_signal_safe_unwind;
 export using cpptrace::can_get_safe_object_frame;
 export using cpptrace::register_jit_object;
 export using cpptrace::unregister_jit_object;
 export using cpptrace::clear_all_jit_objects;

 // cpptrace/exceptions
 export using cpptrace::exception;
 export using cpptrace::lazy_exception;
 export using cpptrace::exception_with_message;
 export using cpptrace::logic_error;
 export using cpptrace::domain_error;
 export using cpptrace::invalid_argument;
 export using cpptrace::length_error;
 export using cpptrace::out_of_range;
 export using cpptrace::runtime_error;
 export using cpptrace::range_error;
 export using cpptrace::overflow_error;
 export using cpptrace::underflow_error;
 export using cpptrace::nested_exception;
 export using cpptrace::system_error;
 export using cpptrace::rethrow_and_wrap_if_needed;

 // cpptrace/formatting
 export using cpptrace::basename;
 export using cpptrace::prettify_symbol;
 export using cpptrace::formatter;
 export using cpptrace::get_default_formatter;

 // cpptrace/forward
 export using cpptrace::frame_ptr;

 // cpptrace/from_current.hpp
 export using cpptrace::raw_trace_from_current_exception;
 export using cpptrace::from_current_exception;
 export using cpptrace::raw_trace_from_current_exception_rethrow;
 export using cpptrace::from_current_exception_rethrow;
 export using cpptrace::current_exception_was_rethrown;
 export using cpptrace::rethrow;
 export using cpptrace::clear_current_exception_traces;
 export using cpptrace::try_catch;

 namespace detail {
 #ifdef _MSC_VER
 export using cpptrace::detail::argument;
 export using cpptrace::detail::exception_filter;
 #else
 export using cpptrace::detail::unwind_interceptor;
 export using cpptrace::detail::unwind_interceptor_for;
 export using cpptrace::detail::nop;
 #endif
 }

 // cpptrace/io
 export using cpptrace::operator<<; // FIXME: make hidden friend

 // cpptrace/utils
 export using cpptrace::demangle;
 export using cpptrace::prune_symbol;
 export using cpptrace::get_snippet;
 export using cpptrace::isatty;
 export using cpptrace::stdin_fileno;
 export using cpptrace::stderr_fileno;
 export using cpptrace::stdout_fileno;
 export using cpptrace::register_terminate_handler;
 export using cpptrace::absorb_trace_exceptions;
 export using cpptrace::enable_inlined_call_resolution;
 export using cpptrace::cache_mode;
 export using cpptrace::log_level;
 export using cpptrace::set_log_level;
 export using cpptrace::set_log_callback;
 export using cpptrace::use_default_stderr_logger;
 export using cpptrace::to_string;
 export using cpptrace::cache_mode;

 namespace experimental {
 export using cpptrace::experimental::set_cache_mode;
 export using cpptrace::experimental::set_dwarf_resolver_line_table_cache_size;
 export using cpptrace::experimental::set_dwarf_resolver_disable_aranges;
 }

 #ifdef _WIN32
 export using cpptrace::load_symbols_for_file;
 #endif
CPPTRACE_END_NAMESPACE

CMake

基础

见 https://github.com/krisfur/cpp26-modules-template

例来自https://cryos.net/2024/01/c-modules-and-cmake

add_library(core)
target_sources(core
 PUBLIC
 FILE_SET CXX_MODULES FILES
 core.cpp)
add_executable(angohr angohr.cpp)
target_link_libraries(angohr PRIVATE core)

关于 import std;

CMake 4.3 已经不需要CMAKE_EXPERIMENTAL_CXX_IMPORT_STD来启用这个功能 (https://github.com/Kitware/CMake/commit/70c1f0f43d48c8b3332ce6b3683d8e5cfb5d90e4)

The experimental gate for C++23’s import std has been dropped.

Variable :variable:CMAKE_CXX_MODULE_STD and property target :prop_tgt:CXX_MODULE_STD control the availability of import std for C++ targets.

Read-only variable :variable:CMAKE_CXX_COMPILER_IMPORT_STD lists the C++ standard levels for which import std is available on the current toolchain.

Variable :variable:CMAKE_CXX_STDLIB_MODULES_JSON sets a specific module metadata file which CMake will use for constructing import std instead of relying on automatic detection via the current C++ compiler.:

CppStacktrace

Sat, 14 Feb 2026 00:00:00 +0000

Cpp23新增了栈追踪，不确定性能如何。

感觉是不如cpptrace

CppOperator

Mon, 20 Oct 2025 00:00:00 +0000

operator"“s

该运算符必须声明（定义）于命名空间或全局域内。

CppDefault

Sun, 19 Oct 2025 00:00:00 +0000

Default 关键词

class ss{
public:
 ss() {};
private:
 int m_num;
};

class cc{
public:
 cc() = default;
private:
 int m_num;
};

实际上default和空函数不大一样。 default通常和不写是等同的

PyIterator

Fri, 17 Oct 2025 00:00:00 +0000

next() 是一个内置函数，用于从迭代器中获取下一个元素。

例：

selected_value = next(q["value"] for q in local_users if q["title"] == user_item)

而 next() 在这里的作用就是从这个生成器表达式中获取第一个满足条件的 q["value"]。

PyNone

Fri, 17 Oct 2025 00:00:00 +0000

None

类似于其他语言的NULL，不过None是一种特殊的值，类型是Nonetype

CppSwitch

Fri, 10 Oct 2025 00:00:00 +0000

范围 case

部分编译器支持 case x ... y

这是编译器扩展。

switch (c) {
case ' ':
 break;
case '0' ... '9':
case '.':
 break;
}

Cpp Inline 关键词

Fri, 19 Sep 2025 00:00:00 +0000

避免ODR

inline 的核心作用是告诉编译器 “允许函数在多个翻译单元中存在相同定义”（解决 ODR 问题）

内联函数

作用

类似宏，进行文本替换。节省栈内存空间消耗。

限制

inline 的使用是有所限制的，inline 只适合涵数体内代码简单的函数使用，不能包含复杂的结构控制语句例如 while、switch，并且不能内联函数本身不能是直接递归函数（即，自己内部还调用自己的函数）。

推荐用于Getter, Setter

inline位置

定义在类中的成员函数默认都是内联的。

在x86-64 clang 21.1.0测试 inline关键词只要在声明或定义中有一处标识即可。这与下方链接矛盾。

不过通常inline只写在定义上，且定义直接放在头文件。

链接

runoob

cpp Static 关键词

Mon, 12 May 2025 00:00:00 +0000

全局

对于全局变量来说，static 关键词只改变其作用域。

静态

全局静态变量或函数具有内部链接（internal linkage），这意味着它只能在定义它的源文件内部被访问。编译器会将静态函数的符号限制在源文件内部，不会生成全局符号。

普通

普通全局变量具有外部链接（external linkage），这意味着它可以在多个源文件中被访问。它的作用域是整个程序，只要在其他文件中使用 extern 声明，就可以访问该变量。

C++报错

Tue, 29 Apr 2025 00:00:00 +0000

未定义引用 undefined reference

模板函数 template function

模板函数需要定义必须在头文件，不能拆成cpp和hpp

静态变量

静态变量要初始化

成员初始化错误 mem_init_not_member_or_class

子类无法使用成员初始器初始化继承的成员。

class Shape {
protected:
 double radius;
};

class Ball : public Shape {
public:
 Ball(double r) : radius(r) {} //error
};
//Member initializer 'radius' does not name a non-static data member or base class (clang mem_init_not_member_or_class)

CPP语法：类型

Mon, 28 Apr 2025 00:00:00 +0000

关键词

typedef（旧式类型别名定义）

typedef int Integer;

using （新式类型别名定义和类型推导）

类型别名定义

C++ 11 后，using 可以用于定义类型别名，与 typedef 类似。

using Integer = int;

可以做到 typedef 无法做到的

template<typename T> using Ptr = T*;

// use
Ptr<int> p;
// =
int* p;

decltype

decltype 用于获取表达式的类型。可以做到类似 template 的效果。

int x = 10;
decltype(x) y = 20;

右值标识

unsigned

u 或 U

0x7fu

float

f 或 F

0.3f

char8_t / char16_t / char32_t

char8_t = u8'a';
char16_t = u16'a';
char32_t = u32'a';

C++函数重载(Overloading)

Thu, 03 Apr 2025 00:00:00 +0000

重载 (Overloading)

(热知识)

只改变参数标识符不形成重载

void Set(int t);
void Set(int a); //function cannot be redeclared

参数的修饰词不形成重构

void Set(int t);
void Set(const int a); //function cannot be redeclared

但是函数修饰const会形成重构

void Get(int t) const;
void Get(int t);

cpp变量的链接属性

Thu, 03 Apr 2025 00:00:00 +0000

非 const 的全局变量默认具有 外部链接(external linkage) ，它们可以在多个 翻译单元(源文件) 之间共享。而 const 变量默认具有 内部链接(internal linkage)，即它们只能在定义它们的 翻译单元 内访问。

非 const 全局变量的默认外部链接

// 文件：file1.cpp
int globalVar = 42; // 默认外部链接，可以在其他文件中访问

void printGlobalVar() {
 std::cout << "globalVar: " << globalVar << std::endl;
}

// 文件：file2.cpp
extern int globalVar; // 声明 globalVar

void printGlobalVarFromAnotherFile() {
 std::cout << "globalVar: " << globalVar << std::endl; // 链接成功
}

const 全局变量的默认内部链接

// 文件：file1.cpp
const int MAX_SIZE = 100; // 默认内部链接，仅在 file1.cpp 中可见

void printMaxSize() {
 std::cout << "MAX_SIZE: " << MAX_SIZE << std::endl;
}

// 文件：file2.cpp
extern const int MAX_SIZE; // 声明 MAX_SIZE，但链接失败
void printMaxSizeFromAnotherFile() {
 std::cout << "MAX_SIZE: " << MAX_SIZE << std::endl; // 链接错误
}

让 const 变量具有外部链接

使用 extern 关键字来改变其链接属性。

// 文件：file1.cpp
extern const int MAX_SIZE = 100; // 外部链接，可以在其他文件中访问

void printMaxSize() {
 std::cout << "MAX_SIZE: " << MAX_SIZE << std::endl;
}

// 文件：file2.cpp
extern const int MAX_SIZE; // 声明 MAX_SIZE
void printMaxSizeFromAnotherFile() {
 std::cout << "MAX_SIZE: " << MAX_SIZE << std::endl; // 链接成功
}

cpp-CMake项目管理

Mon, 24 Mar 2025 00:00:00 +0000

工程文件结构示例

Project
├── .git/
├── .github/
│ └── workflows/
├── assets/
├── attic/
├── cmake/
├── doc/
├── lib/
├── scripts/
├── source/
│ ├── application/
│ │ ├── CMakeLists.txt
│ │ ├── XXApplication.cpp
│ │ └── XXApplication.hpp
│ ├── base/
│ ├── core/
│ ├── extern/
│ ├── test/
│ ├── utility/
│ ├── CMakeLists.txt
│ ├── CMakePresets.json
│ ├── vcpkg-configuration.json
│ └── vcpkg.json
├── toolchains/
├── triplets/
├── .clang-format
├── .gitattributes
├── .gitignore
└── README.md

source内的每个文件夹都是一个lib或exe，内容都与application类似，就不重复列举了。

变量

不喜欢定义大量变量，可以用递归赋值

set(sint_application_SOURCESS
 XXApplication.cpp
 )

#P2P
set(sint_application_SOURCES ${star_application_HEADERS}
 P2PNet.cpp
 )

头文件搜索路径

基本就一点

set(SINT_GRAPHCS_INCLUDES ${PROJECT_SOURCE_DIR}/graphics)
add_subdirectory(graphics)
 
target_include_directories(test PRIVATE ${SINT_GRAPHCS_INCLUDES})

要注意的是

必须先设置(set)变量，再添加子目录(add_subdirectory) target_include_directories 参数3必须是路径，不能用变量

OBJECT 库

add_library(<name> [STATIC | SHARED | OBJECT] source2 [source2 ...]) 创建对象库。对象库不会生成一个单独的库文件，而是生成一系列对象文件（.o 或 .obj 文件）。这些对象文件可以在后续的构建目标中被重用，例如同时构建静>态库和动态库。

推荐使用OBJECT库。

通用函数，如读取文件等，可以作为OBJECT库保存，而不是STATIC或SHARED，这两种会生成为一个单独的文件。

使用：

add_executable(my_app main.cpp $<TARGET_OBJECTS:common>)

输出运行文件到指定目录

set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/../dist)

其他链接

yuque

C#笔记

Fri, 16 Aug 2024 00:00:00 +0000

class

在csharp中，类是引用类型，而在cpp 类是值类型

null!

null包容运算符假定空值，方便在必须始终有值时定义空值。这玩意就是面向IDE，跳过警告的。

nameof方法

有什么用？主要用解决类成员名做参数替代成员们的字符串做参数。不影响性能，会在编译阶段被替换，因此并不是真正的动态捕捉。不过比起用字符串来反射强点，毕竟如果名字变了，ide会报错。