最稳妥做法是将类定义、实现和main()全放在一个.cpp文件中，用g++一行编译运行；常见错误如“undefined reference”多因声明与定义分离后未同时编译或遗漏构造函数定义。
怎么写一个能直接编译运行的 C++ 类示例
最稳妥的做法是：把类定义、类实现（如果分离）、以及 main() 全部放在一个 .cpp 文件里，用 g++ 一行命令就能跑通。别一上来就拆头文件、源文件、CMake，那不是写示例，是搭工程。
常见错误现象：undefined reference to 'MyClass::MyClass()'——多半是因为声明和定义分开了但没一起编译，或者忘了定义构造函数。
- 类定义尽量放文件顶部（或单独
myclass.h，但示例阶段建议 inline） - 所有成员函数，哪怕只有声明，只要被调用了，就必须有定义（哪怕是空实现）
-
main()函数必须存在，且返回int - 别用
using namespace std;在头文件里；示例中可放main前，不伤大雅
#include <iostream><p>class Calculator {
public:
int add(int a, int b) { return a + b; }
int multiply(int a, int b) { return a * b; }
};</p>
<p>int main() {
Calculator calc;
std::cout </p>
<h3>什么时候该把类拆成 .h 和 .cpp</h3>
<p>当示例开始体现“接口与实现分离”意图时才拆，比如想模拟真实项目结构、或展示 <code>#include</code> 依赖关系。但注意：拆了就必须确保编译器能同时看到声明和定义。</p>
<p>使用场景：教别人理解头文件作用、演示链接过程、或为后续扩展留接口。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2823" title="C++14"><img
src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="overflowclass">C++14</a>
<p class="overflowclass">C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<ul>
<li>
<code>myclass.h</code> 只放类声明、<code>#pragma once</code> 或卫士宏，不写函数体</li>
<li>
<code>myclass.cpp</code> 包含 <code>myclass.h</code>，实现所有非内联函数</li>
<li>编译命令得同时指定两个文件：<code>g++ main.cpp myclass.cpp -o demo</code>
</li>
<li>如果在 <code>myclass.h</code> 里写了函数体（比如 <code>inline</code> 或短函数），它就自动变成内联，此时 <code>.cpp</code> 文件可省略</li>
</ul>
<h3>为什么加 const 成员函数和 const 对象容易出错</h3>
<p>初学者常忽略 <code>const</code> 修饰对示例可信度的影响——真实类往往要支持只读访问，而漏写 <code>const</code> 会导致 <code>const</code> 对象无法调用该函数，编译直接报错：<code>error: passing 'const MyClass' as 'this' argument discards qualifiers</code>。</p>
<ul>
<li>如果函数不修改成员变量，就加上 <code>const</code> 后缀，比如 <code>int get_value() const;</code>
</li>
<li>示例里创建 <code>const</code> 对象（如 <code>const Calculator c;</code>），再调用带 <code>const</code> 的函数，能立刻验证是否正确定义</li>
<li>构造函数、析构函数、<code>operator=</code> 等默认不是 <code>const</code>，不用加；只有普通访问器函数才需要</li>
</ul>
<h3>避免示例失效的三个隐蔽细节</h3>
<p>看似简单的示例，常因环境或标准差异崩在别人机器上。关键不是“能不能跑”，而是“换台机器、换个编译器还能不能跑”。</p>
<ul>
<li>别用 C++20 特性（如 <code>std::format</code>）写基础示例；加 <code>-std=c++17</code> 编译参数更稳妥</li>
<li>路径里别含中文或空格，尤其 Windows 下用 MinGW 或 WSL 时，<code>#include "我的类.h"</code> 会静默失败</li>
<li>如果类里用了 <code>std::vector</code> 或 <code>std::string</code>，记得 <code>#include</code> 对应头文件——示例里漏掉 <code>#include <string></string></code> 是高频翻车点</li>
</ul>
<p>真正难的不是写出语法正确的类，而是让别人复制粘贴后不改一行就能 <code>g++ demo.cpp && ./demo</code> 跑出结果。路径、标准、头文件、const 正确性，四者缺一不可。</p></iostream>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
