使用你提供的 SDK 下載鏈接，親測(cè)可編譯（linux x64 g++）。

源碼目錄結(jié)構(gòu)如下

.
├── a.cpp
├── a.h
├── aip-cpp-sdk-0.4.0
│?? ├── base
│?? │?? ├── base64.h
│?? │?? ├── base.h
│?? │?? ├── http.h
│?? │?? └── utils.h
│?? ├── face.h
│?? ├── image_censor.h
│?? ├── image_classify.h
│?? ├── image_search.h
│?? ├── kg.h
│?? ├── nlp.h
│?? ├── ocr.h
│?? ├── README.md
│?? └── speech.h
├── main.cpp
└── Makefile

文件 a.h 內(nèi)容如下

#ifndef _a_h_
#define _a_h_
bool call_speech();
#endif

文件 a.cpp 內(nèi)容如下

#include "aip-cpp-sdk-0.4.0/speech.h"
#include <json/json.h>

bool call_speech() {
    aip::Speech sp("app_id", "ak", "sk");
    Json::Value data;
    Json::Value result = sp.request_asr("url", data);
    return result.isString();
}

文件 main.cpp 內(nèi)容如下

#include "a.h"

int main()
{
    return call_speech() ? 0: 1;
}

文件 Makefile 內(nèi)容如下

demo: a.cpp main.cpp
    g++ -Wall -std=c++11 -g $^ -o $@ -lcurl -lcrypto -ljsoncpp

使用命令 make 順利編譯。

---

由于你沒有貼出調(diào)用 SDK 的相關(guān)代碼，我無法準(zhǔn)確判斷原因。

以上面的代碼結(jié)構(gòu)為例，你很可能在 a.h 里引用了 SDK 的頭文件，然后在 a.cpp 里面引用了 a.h 頭文件，類似這樣

// a.h 文件內(nèi)容
#ifndef _a_h_
#define _a_h_
#include "aip-cpp-sdk-0.4.0/speech.h"
#include <json/json.h>

bool call_speech();
#endif


// a.cpp 文件內(nèi)容
#include "a.h"
#include <json/json.h>

bool call_speech() {
.......

這種寫法就會(huì)出現(xiàn) “重復(fù)定義” 的錯(cuò)誤，。

---

SDK 下載地址: http://ai.baidu.com/download?...

瀉藥, @李毅 老大已經(jīng)點(diǎn)名你出錯(cuò)的地方了, @felix 老大也指出是ODR的問題, 看來窩除了能在上面說下原理沒什麼做了, 哈哈. 不過既然兩位老大都沒有將原理和你的庫結(jié)合, 那麼這個(gè)微小工作就由窩踩在兩位老大的肩膀上來完成吧.

科普基礎(chǔ)知識(shí)

窩給你結(jié)合標(biāo)準(zhǔn)文檔從頭梳理一些c++裏面必須知道的入門常識(shí)性概念, 這些概念可能你會(huì)覺得過有點(diǎn)多餘, 但是這些是每一個(gè)寫c++的必須知道的基礎(chǔ). 並且窩在這裏會(huì)剔除些標(biāo)準(zhǔn)裏的wording, 只會(huì)提及此處需要用到的概念.

以下引用皆出自N4741, 歌詞大意可以理解爲(wèi)Informally的簡略版解釋(可能有錯(cuò)誤的私貨, 如有老大看出, 望告知)

Include guard

這在標(biāo)準(zhǔn)裏面沒有, 只是c++程序員爲(wèi)了實(shí)現(xiàn)ODR的一個(gè)慣用法罷了, 通過conditional inclusion在頭文件裏面定義大部分時(shí)間都可以用#pragma once 來代替, 不過窩有一次被一個(gè)大佬警告過其可移植性, 但是窩查了下發(fā)現(xiàn)msvc, clang, gcc, icc, xl都zici呀...可能是有標(biāo)準(zhǔn)潔癖吧.

Translation unit

The text of the program is kept in units called source files in this document. A source file together with all the headers (20.5.1.2) and source files included (19.2) via the preprocessing directive#include, less any source lines skipped by any of the conditional inclusion (19.1) preprocessing directives, is called a translation unit.

歌詞大意: 每一個(gè)源文件(.cpp/.cc/.cxx等)在使用了include guard後展開頭文件(.hh/.hpp/.h等)(即複製頭文件所有內(nèi)容進(jìn)源文件)

Declarations and definitions

Each entity declared by a declaration is also defined by that declaration, unless..........

歌詞大意, $$\mathsf{definitions} \subset \mathsf{declarations}$$, 這就是這兩者的關(guān)係, 不過窩在某個(gè)dlang的群裏發(fā)現(xiàn)很多寫了c++多年的選手依然不知道這一點(diǎn), 這是很致命的, 比如不熟悉其區(qū)別可能就會(huì)產(chǎn)生窩這樣的困惑:https://stackoverflow.com/que... 還可能有其它危害, 下文也會(huì)提及.

One Definition Rule(ODR)

在n4741中, ODR分爲(wèi)了12大點(diǎn), 以後還可能擴(kuò)充或修改, 前些日子在so上看到一個(gè)語言律師在odr-use上發(fā)現(xiàn)了自相矛盾的地方. 不過這裏只需要說下兩點(diǎn)就行了.

1) No translation unit shall contain more than one definition of any variable, function, class type, enumeration type, or template.

ODR-use

本來不想說odr-used的, 但是發(fā)現(xiàn)還是脫不開它.

A variable x whose name appears as a potentially-evaluated expression ex is odr-used by ex unless applying the lvalue-to-rvalue conversion (7.1) to x yields a constant expression (8.6) that does not invoke any non-trivial functions and, if x is an object,ex is an element of the set of potential results of an expressione, where either the lvalue-to-rvalue conversion (7.1) is applied toe, or e is a discarded-value expression (8.2).

歌詞大意: 先要瞭解potentially-evaluated expression是什麼, 花個(gè)1分鐘看下這個(gè)帖子: https://stackoverflow.com/que... 好, 當(dāng)ex滿足potentially-evaluated expression的性質(zhì)時(shí), 除非做了左值->右值的轉(zhuǎn)換(如x作爲(wèi)返回值, 但是是按值返回的), 亦或是x本身不是object, 比如x可以是引用(另一種情況這不解釋了, 不然牽扯的概念就太多了). 好, 說這些可能會(huì)有點(diǎn)混, 其實(shí), 你需要知道的是odr-use的意思就是如字面所說--需要definition的存在, 而不僅僅是declaration(現(xiàn)在你應(yīng)該明白爲(wèi)什麼窩在一開始就要區(qū)分definition和declaration及其子集關(guān)係了吧).

繼續(xù)回到One definition rule的定義

10) Every program shall contain exactly one definition of every non-inline function or variable that is odr-used in that program outside of a discarded statement (9.4.1); no diagnostic required. The definition can appear explicitly in the program, it can be found in the standard or a user-defined library, or (when appropriate) it is implicitly defined (see 15.1, 15.4 and 15.8). An inline function or variable shall be defined in every translation unit in which it is odr-used outside of a discarded statement.

歌詞大意: 對(duì)於函數(shù)或者變量, 在整個(gè)程序中也要遵循odr原則, 但是很明顯頭文件會(huì)被很多源文件包含, 該怎麼辦呢? inline用來開洞解決這個(gè)問題, 加了inline, 對(duì)函數(shù)的odr檢查就被無視了(當(dāng)然, 很多時(shí)候會(huì)自動(dòng)inline, 比如類內(nèi)定義, friend等).

---

根據(jù)原理剖析錯(cuò)因.

窩不知道你自己的程式結(jié)構(gòu), 那麼我就沿用@李毅 老大給出的文件組織了:

├── a.cpp
├── a.h
├── aip-cpp-sdk-0.4.0
│   ├── base
│   │   ├── base64.h
│   │   ├── base.h
│   │   ├── http.h
│   │   └── utils.h
│   ├── face.h
│   ├── image_censor.h
│   ├── image_classify.h
│   ├── image_search.h
│   ├── kg.h
│   ├── nlp.h
│   ├── ocr.h
│   ├── README.md
│   └── speech.h
├── main.cpp
└── Makefile

很明顯, translation parsion之後我們由a.cpp和main.cpp兩個(gè)翻譯單元存在, 好, 我們通過展開這兩個(gè)翻譯單元來分析爲(wèi)什麼你自己寫的(即版本二)會(huì)違背ODR, 而@李毅 老大給出的第一個(gè)版本就不會(huì). 爲(wèi)了進(jìn)一步簡化問題, 我們把#include <json/json.h>不予考慮, 規(guī)定base/base.h的內(nèi)容除去include guard僅有#include "base64.h一行, base/base64.h除去include guard有

include "iostream" 
namespace aip { void f() { std::cout << "hello"; }

speech.h除去include guard有

#include "base/base.h"
namespace aip {
    void f_s() {
        aip::f_i();
    }
}

main.c有:

#include "a.h"
int main()
{
    f_a();
}

版本一

a.cpp(稍作簡化)

#include "aip-cpp-sdk-0.4.0/speech.h"

void f_a()
{
    aip::f_s();
}

$$=>$$

#include "aip-cpp-sdk-0.4.0/base/base.h"
namespace aip {
    void f_s() {
        aip::f_i();
    }
}

void f_a()
{
    aip::f_s();
}

$$=>$$

#include "aip-cpp-sdk-0.4.0/base/base64.h"
namespace aip {
    void f_s() {
        aip::f_i();
    }
}

void f_a()
{
    aip::f_s();
}

$$=>$$

include <iostream>
namespace aip { void f() { std::cout << "hello"; }
namespace aip {
    void f_s() {
        aip::f_i();
    }
}

void f_a()
{
    aip::f_s();
}

main.cpp

#include "a.h"

int main()
{
    f_a();
}

$$=>$$

bool f_a();
int main()
{
    f_a();
}

小結(jié)

可見這個(gè)版本展開到最後沒有違背ODR的部分.

版本二

a.cpp

#include "a.h"

void f_a()
{
    aip::f_s();
}

$$=>$$

#include "aip-cpp-sdk-0.4.0/base/base64.h"
void f_a();

void f_a()
{
    aip::f_s();
}

接下來的步驟幾乎於版本一相同了, 直接貼最後結(jié)果:

void f_a();

include <iostream>
namespace aip { void f() { std::cout << "hello"; }
namespace aip {
    void f_s() {
        aip::f_i();
    }
}

void f_a()
{
    aip::f_s();
}

main.cpp

#include "a.h"
int main()
{
    f_a();
}

只要展開a.h, 上面也有此步驟, 所以直接給結(jié)果:

void f_a();

include <iostream>
namespace aip { void f() { std::cout << "hello"; }
namespace aip {
    void f_s() {
        aip::f_i();
    }
}

int main()
{
    f_a();
}

小結(jié)

好, 其實(shí)我們很容易發(fā)現(xiàn), 版本二的兩個(gè)翻譯單元都會(huì)包含aip::f_i()和aip::f_i的definition, 再結(jié)合原理部分的最後一段, 這明顯違反了ODR`, 所以是錯(cuò)誤的

解決方案

兩位老大已經(jīng)給出了方案了, 要麼你自己的頭文件和源文件小心處理, 理清依賴關(guān)係, 要麼你就給庫函數(shù)加上inline, 屏蔽ODR檢查.

誰背鍋?

1. c++. 沒有module, 只能依靠這種落伍的include guard和inline來解決這種包含和符號(hào)檢查, 很容易會(huì)混亂心智
2. c. 歷史殘留
3. 庫的作者, 窩懷疑他們自己都沒有用過自己寫的這個(gè)庫.

@藤壺女御_ 老大誤以爲(wèi)窩是臺(tái)灣人, 真是夭壽啦:P 畢竟窩吃不起茶葉蛋, 用著799的碎屏紅米(碎1年了), 穿著迪卡農(nóng)的鞋子, 筆記本的價(jià)格也只有1700RMB(3年了已經(jīng)), 只是最近喜歡上繁體字了, 所以窩用byvoid老大的Open CC提供簡體版:

---

---

瀉藥, @李毅 老大已經(jīng)點(diǎn)名你出錯(cuò)的地方了, @felix 老大也指出是ODR的問題, 看來窩除了能在上面說下原理沒什么做了, 哈哈. 不過既然兩位老大都沒有將原理和你的庫結(jié)合, 那么這個(gè)微小工作就由窩踩在兩位老大的肩膀上來完成吧.

科普基礎(chǔ)知識(shí)

窩給你結(jié)合標(biāo)準(zhǔn)文檔從頭梳理一些c++里面必須知道的入門常識(shí)性概念, 這些概念可能你會(huì)覺得過有點(diǎn)多余, 但是這些是每一個(gè)寫c++的必須知道的基礎(chǔ). 并且窩在這里會(huì)剔除些標(biāo)準(zhǔn)里的wording, 只會(huì)提及此處需要用到的概念.

以下引用皆出自N4741, 歌詞大意可以理解為Informally的簡略版解釋(可能有錯(cuò)誤的私貨, 如有老大看出, 望告知)

Include guard

這在標(biāo)準(zhǔn)里面沒有, 只是c++程序員為了實(shí)現(xiàn)ODR的一個(gè)慣用法罷了, 通過conditional inclusion在頭文件里面定義大部分時(shí)間都可以用#pragma once 來代替, 不過窩有一次被一個(gè)大佬警告過其可移植性, 但是窩查了下發(fā)現(xiàn)msvc, clang, gcc, icc, xl都zici呀...可能是有標(biāo)準(zhǔn)潔癖吧.

Translation unit

The text of the program is kept in units called source files in this document. A source file together with all the headers (20.5.1.2) and source files included (19.2) via the preprocessing directive#include, less any source lines skipped by any of the conditional inclusion (19.1) preprocessing directives, is called a translation unit.

歌詞大意: 每一個(gè)源文件(.cpp/.cc/.cxx等)在使用了include guard后展開頭文件(.hh/.hpp/.h等)(即復(fù)制頭文件所有內(nèi)容進(jìn)源文件)

Declarations and definitions

Each entity declared by a declaration is also defined by that declaration, unless..........

歌詞大意, $$\mathsf{definitions} \subset \mathsf{declarations}$$, 這就是這兩者的關(guān)系, 不過窩在某個(gè)dlang的群里發(fā)現(xiàn)很多寫了c++多年的選手依然不知道這一點(diǎn), 這是很致命的, 比如不熟悉其區(qū)別可能就會(huì)產(chǎn)生窩這樣的困惑:https://stackoverflow.com/que... 還可能有其它危害, 下文也會(huì)提及.

One Definition Rule(ODR)

在n4741中, ODR分為了12大點(diǎn), 以后還可能擴(kuò)充或修改, 前些日子在so上看到一個(gè)語言律師在odr-use上發(fā)現(xiàn)了自相矛盾的地方. 不過這里只需要說下兩點(diǎn)就行了.

1) No translation unit shall contain more than one definition of any variable, function, class type, enumeration type, or template.

ODR-use

本來不想說odr-used的, 但是發(fā)現(xiàn)還是脫不開它.

A variable x whose name appears as a potentially-evaluated expression ex is odr-used by ex unless applying the lvalue-to-rvalue conversion (7.1) to x yields a constant expression (8.6) that does not invoke any non-trivial functions and, if x is an object,ex is an element of the set of potential results of an expressione, where either the lvalue-to-rvalue conversion (7.1) is applied toe, or e is a discarded-value expression (8.2).

歌詞大意: 先要了解potentially-evaluated expression是什么, 花個(gè)1分鐘看下這個(gè)帖子: https://stackoverflow.com/que... 好, 當(dāng)ex滿足potentially-evaluated expression的性質(zhì)時(shí), 除非做了左值->右值的轉(zhuǎn)換(如x作為返回值, 但是是按值返回的), 亦或是x本身不是object, 比如x可以是引用(另一種情況這不解釋了, 不然牽扯的概念就太多了). 好, 說這些可能會(huì)有點(diǎn)混, 其實(shí), 你需要知道的是odr-use的意思就是如字面所說--需要definition的存在, 而不僅僅是declaration(現(xiàn)在你應(yīng)該明白為什么窩在一開始就要區(qū)分definition和declaration及其子集關(guān)系了吧).

繼續(xù)回到One definition rule的定義

10) Every program shall contain exactly one definition of every non-inline function or variable that is odr-used in that program outside of a discarded statement (9.4.1); no diagnostic required. The definition can appear explicitly in the program, it can be found in the standard or a user-defined library, or (when appropriate) it is implicitly defined (see 15.1, 15.4 and 15.8). An inline function or variable shall be defined in every translation unit in which it is odr-used outside of a discarded statement.

歌詞大意: 對(duì)于函數(shù)或者變量, 在整個(gè)程序中也要遵循odr原則, 但是很明顯頭文件會(huì)被很多源文件包含, 該怎么辦呢? inline用來開洞解決這個(gè)問題, 加了inline, 對(duì)函數(shù)的odr檢查就被無視了(當(dāng)然, 很多時(shí)候會(huì)自動(dòng)inline, 比如類內(nèi)定義, friend等).

---

根據(jù)原理剖析錯(cuò)因.

窩不知道你自己的程式結(jié)構(gòu), 那么我就沿用@李毅 老大給出的文件組織了:

├── a.cpp
├── a.h
├── aip-cpp-sdk-0.4.0
│   ├── base
│   │   ├── base64.h
│   │   ├── base.h
│   │   ├── http.h
│   │   └── utils.h
│   ├── face.h
│   ├── image_censor.h
│   ├── image_classify.h
│   ├── image_search.h
│   ├── kg.h
│   ├── nlp.h
│   ├── ocr.h
│   ├── README.md
│   └── speech.h
├── main.cpp
└── Makefile

很明顯, translation parsion之后我們由a.cpp和main.cpp兩個(gè)翻譯單元存在, 好, 我們通過展開這兩個(gè)翻譯單元來分析為什么你自己寫的(即版本二)會(huì)違背ODR, 而@李毅 老大給出的第一個(gè)版本就不會(huì). 為了進(jìn)一步簡化問題, 我們把#include <json/json.h>不予考慮, 規(guī)定base/base.h的內(nèi)容除去include guard僅有#include "base64.h一行, base/base64.h除去include guard有

include "iostream" 
namespace aip { void f() { std::cout << "hello"; }

speech.h除去include guard有

#include "base/base.h"
namespace aip {
    void f_s() {
        aip::f_i();
    }
}

main.c有:

#include "a.h"
int main()
{
    f_a();
}

版本一

a.cpp(稍作簡化)

#include "aip-cpp-sdk-0.4.0/speech.h"

void f_a()
{
    aip::f_s();
}

$$=>$$

#include "aip-cpp-sdk-0.4.0/base/base.h"
namespace aip {
    void f_s() {
        aip::f_i();
    }
}

void f_a()
{
    aip::f_s();
}

$$=>$$

#include "aip-cpp-sdk-0.4.0/base/base64.h"
namespace aip {
    void f_s() {
        aip::f_i();
    }
}

void f_a()
{
    aip::f_s();
}

$$=>$$

include <iostream>
namespace aip { void f() { std::cout << "hello"; }
namespace aip {
    void f_s() {
        aip::f_i();
    }
}

void f_a()
{
    aip::f_s();
}

main.cpp

#include "a.h"

int main()
{
    f_a();
}

$$=>$$

bool f_a();
int main()
{
    f_a();
}

小結(jié)

可見這個(gè)版本展開到最后沒有違背ODR的部分.

版本二

a.cpp

#include "a.h"

void f_a()
{
    aip::f_s();
}

$$=>$$

#include "aip-cpp-sdk-0.4.0/base/base64.h"
void f_a();

void f_a()
{
    aip::f_s();
}

接下來的步驟幾乎于版本一相同了, 直接貼最后結(jié)果:

void f_a();

include <iostream>
namespace aip { void f() { std::cout << "hello"; }
namespace aip {
    void f_s() {
        aip::f_i();
    }
}

void f_a()
{
    aip::f_s();
}

main.cpp

#include "a.h"
int main()
{
    f_a();
}

只要展開a.h, 上面也有此步驟, 所以直接給結(jié)果:

void f_a();

include <iostream>
namespace aip { void f() { std::cout << "hello"; }
namespace aip {
    void f_s() {
        aip::f_i();
    }
}

int main()
{
    f_a();
}

小結(jié)

好, 其實(shí)我們很容易發(fā)現(xiàn), 版本二的兩個(gè)翻譯單元都會(huì)包含aip::f_i()和aip::f_i的definition, 再結(jié)合原理部分的最后一段, 這明顯違反了ODR`, 所以是錯(cuò)誤的

解決方案

兩位老大已經(jīng)給出了方案了, 要么你自己的頭文件和源文件小心處理, 理清依賴關(guān)系, 要么你就給庫函數(shù)加上inline, 屏蔽ODR檢查.

誰背鍋?

1. c++. 沒有module, 只能依靠這種落伍的include guard和inline來解決這種包含和符號(hào)檢查, 很容易會(huì)混亂心智
2. c. 歷史殘留
3. 庫的作者, 窩懷疑他們自己都沒有用過自己寫的這個(gè)庫.

@藤壺女御_ 老大誤以為窩是臺(tái)灣人, 真是夭壽啦:P 畢竟窩吃不起茶葉蛋, 用著799的碎屏紅米(碎1年了), 穿著迪卡農(nóng)的鞋子, 筆記本的價(jià)格也只有1700RMB(3年了已經(jīng)), 只是最近喜歡上繁體字了

參考: http://eel.is/c++draft/#tab

看起來最可能是因?yàn)檫@個(gè)頭文件不是用來讓你包含的。

如何產(chǎn)生的？
這個(gè)鏈接錯(cuò)誤是由于違背了ODR。即在你的程序中，同一個(gè)非內(nèi)聯(lián)函數(shù)被多次定義。

解決方案：

1. 不要包含這樣的頭文件。
2. 在所有這樣的函數(shù)前加上inline。
3. 只在一個(gè)源文件中包含這樣的頭文件。

當(dāng)然還有很多別的方案，就不一一列舉了。總之，你需要保證在所有參與編譯的源文件（更準(zhǔn)確的說是參與鏈接的目標(biāo)文件）中，這樣的頭文件（定義了非內(nèi)聯(lián)函數(shù)的頭文件）至多只被其中的一個(gè)包含。

PS:和命名空間完全沒關(guān)系。