标题：清越战争
背景
18世纪的时候，越南全境分为南北两部份。南方由阮主统治，北方由郑主挟持后黎朝皇帝作为傀儡统治。阮主和郑主的腐败导致了民众的不满，1771年，阮岳、阮侣、阮惠三兄弟在西山邑举兵，反抗阮主的统治。西山起义军击退了暹罗的援军，推翻了南方的阮主；并以扶黎灭郑为名义于1786年北伐，推翻了郑主，让后黎朝愍宗皇帝亲政，统治北方。
起因
但北方后黎朝陷入内乱，郑主复辟；随后阮有整驱逐郑主专权用事。阮惠遣武文任再次北伐，攻占了升龙，另立宗室黎维(礻堇)监国。而武文任图谋割据升龙称雄，  阮惠再次出兵前往升龙，将武文任诱杀。阮惠留将领吴文楚留守升龙，自己则返回根据地富春。
黎愍宗携家眷出奔高平。皇太后阮氏等人在高平都统阮辉宿的保护下，经高平逃入清朝广西太平府下属的龙州境内，后被安置在南宁。阮氏遣阮辉宿、黎㬎（一作“黎侗”）、黄益晓、阮廷灌、阮国练、阮廷枚六人向清朝的两广总督孙士毅、巡抚孙永清告急。而黎愍宗前往山南、皇弟黎维袖前往宣光、兴化一带纠集各路遗臣反抗西山军。
孙士毅向乾隆帝上表奏称此事，建议乾隆帝发兵讨伐安南，扶黎愍宗重登皇位。而孙永清则提出不同的观点，认为当时后黎朝势力弱小西山朝强大，后黎朝必然会被西山朝灭亡，建议按兵不动。乾隆帝与内阁大学士和珅商量之后，决定出兵安南。其出师的真实目的，中越史料中记载不同，《清史稿·越南传》称其目的是兴灭继绝、灭阮扶黎，原非利其土地；但越南《大南列传前编·伪西列传》则有在中国史料中不曾出现的说法，称孙士毅曾向乾隆帝提出出兵安南后，发兵镇守安南，扶黎愍宗继位担任傀儡皇帝。
清军出师
1788年，孙士毅奉旨，调两广、云贵之兵出征安南。孙士毅与提督许世亨率两广兵一万出镇南关（今中越边境友谊关），镇守谅山的西山将潘启德投降，阮文艳逃往京北（今北宁省）。孙士毅遂以八千人直捣升龙，以二千人驻守谅山为声援。田州知府岑宜栋率军进入高平。云南提督乌大经率部八千人取道开化府的马白关（今云南文山市马关），渡过赌咒河，进入宣化镇。云贵总督富纲驻守都龙（在马白关之南），负责监督粮饷的运输。同时移檄安南各路，劝各地西山军投降，其檄文为：
“兴灭继绝，义所当为。何外于蛮羌，极溺救焚，不得已乃见于兵革。念安南黎氏，本天朝贡臣，三百余年执壤奠虔供厥服，一十五路，锡土封奄有其邦。乃于乾隆年间，国酋阮岳、阮惠等，称兵作乱，袭破罗城。前黎王忧惧物故，嗣孙维祁播越于外。故臣阮辉宿奉嗣孙母妻奔投内地，恳请援兵。经查宿等，嗣孙现栖北谅地方，臣民犹思故主。阮岳以犬羊之夷，肆豺狼之毒，所在虏掠，百姓怨入骨髓。夫以边氓崛起，干常逆理，天道之所不容；敢于内地横行，虐众残民，王法之所当讨。业经题奏钦奉，大皇帝矜恤黎氏之丧亡，不忍交州之涂炭，特命督抚佩征蛮大将军印，调兵五十万，直抵罗城，明正阮岳等罪恶，无容得以逃天之诛。该国世戴黎王，久蒙豢养，知能不泯，感发由衷，不可丧其天良，忘君从敌。有能先唱义声，倚天朝为大援，纠合同志，戮力歼仇，榆塞奏凯，幕府上功。胙土分茅，俾与黎氏同其福庆，如郑大爷故事。檄文传到，勒兵激昂，修尔干戈，敌王所忾，一乃心力，其克有勋，仰覃颁赏于军中，永保同休于国内，尚其勖哉。”
清军的入侵
10月，孙士毅、许世亨由谅山分路进军升龙，广西总兵尚维升、副将庆成率广西兵，广东总兵张朝龙、李化龙率广东兵进军。后黎朝遗臣纷纷响应，宣称清军数十万来吓唬西山军。沿途的西山军不知虚实，惊恐之下纷纷大败溃散。唯独三江一带的西山军据险顽抗。十一月十三日，尚维升率广西兵趁雾天大破西山军，渡过寿昌江；张朝龙也率广东兵破西山军于柱石。
十五日，清军兵至市球江。市球江江面宽广，西山军在南岸向对岸的清军开炮，致使清军无法渡江。孙士毅派遣二千人奇兵绕过山的背面偷袭西山军；另一方面令人建造浮桥以欺骗西山军。西山军中计，十七日在清军奇兵的偷袭大败。
十九日，清军到达富良江（今红河），大破西山军。而富良江乃是通往升龙的门户，消息传到升龙后，镇守升龙的西山朝大司马吴文楚非常惊恐，遣文官阮衙等人前往孙士毅营中求和，请求立黎维(礻堇)为监国，以为缓兵之计，等待富春阮惠的援军。孙士毅拒绝了这个请求。吴文楚召集众将商议，最终接受了吴时任的主张，决定保存西山军的实力，焚毁并抛弃了升龙城，退往三叠山（位于宁平省和清化省交界处）据守。
阮惠北上救援
孙士毅率清军兵不血刃地占领了升龙，但升龙已经成为一片废墟。黎愍宗得知清军到来，前往升龙谒见孙士毅。孙士毅奉乾隆帝的旨意，册封黎愍宗为安南国王。但孙士毅自恃有恩于黎愍宗，十分轻视他。黎愍宗每天都要到孙士毅的营中参谒。有一次孙士毅并没有接见他，而是派遣传令兵简单地宣布没有事务，要黎愍宗回去休息。后黎朝遗臣们对此愤愤不平，但又无可奈何。
孙士毅奏表战功，并请求继续进军攻打阮惠的根据地富春。而云南乌大经的部队尚未到达升龙，因此乾隆帝十分高兴，封孙士毅为一等谋勇公、许世亨为一等子，各将士也都有赏。
但对于孙士毅进军的请求，乾隆帝认为安南地区久经战火，残破空虚；后黎朝皇帝已经有好几代没有实权了，其气数已尽。而且清军长途跋涉十分劳苦，如今已经将黎愍宗扶上皇位，没有出征的必要，因此下令孙士毅班师回朝。
孙士毅贪功，没有立即班师回朝  黎愍宗在孙士毅的军营接受清朝册封，而是率部在升龙逗留享乐。他和所率的清军在升龙度过了春节，计划在正月初六南下进攻富春。
与此同时，阮惠得知了清军入侵的消息，率师北上。由于清朝是以扶黎愍宗归国登位为名义的，西山朝诸将纷纷请求正出师之名，于是阮惠于十一月十五日登基即位，改年号为光中，率水陆之军齐进。二十九日，阮惠的军队驻扎于乂安一带，研究了清军的作战计划。乂安是阮惠的祖籍地，在这里西山军得到了充分的休整，并招募了大量农民入伍，选拔了十万余人、大象数百匹，并举行了大阅兵。阮惠集合西山军，发表演说：
“清师来侵，现在升龙，汝等已知否？天地之间，星野分别；南北分治，北人非我族类，其心则异。自汉以来，北国之人寇我甸畿，渔肉我生民，囊括我财货。人不堪命，咸思逐之。在汉有征女王，在宋有丁先皇、黎大行皇帝，在元有陈兴道大王，在明有黎太祖皇帝，不忍坐视残暴，顺人心，兴义兵，皆能一战取胜，逐之北还。当此之时，北南自在，边境以宁，传祚久长。自丁以来，不至如昔者内属之苦，利害得失，皆前朝故事。今清人复来，谋取我南国，置为郡县，不以宋、元、明为戒。故我出而驱之。汝等各有知能，当与我戮力同心，使大勋用集。毋徒狃习故态，妄怀二心，事发即行诛戮，一无所赦，句谓我不先告也。”  
西山军听后愤慨激昂，皆有斗志。阮惠随后宣布西山军提前过春节，并相约在升龙城共度开春日（即正月初七）。
十二月二十日（西历1789年1月15日），阮惠进军三叠山，与大司马吴文楚、内侯潘文璘的部队会合。阮惠称赞了吴时任的计谋，兵分五队，进攻清军。
第一队：阮惠自己率领，为主力部队，直接进攻升龙，以吴文楚、潘文璘为先锋，嘑虎侯殿后。 
第二队：阮文雪（都督雪）率左军水师越过海港进入禄头河，负责进攻海阳，为东道之接应； 
第三队：阮文禄（都督禄）率左军水师越过海港进入禄头河，进攻谅江、凤眼、安世等地，以截断清军的退路。 
第四队：都督谋率右军象兵、马兵，走山道出击西面，穿过彰德县（今河内市河东彰美县），取路直趋清池县的仁睦村，横击岑宜栋所率的田州兵。 
第五队：邓春保（都督保）率右军象兵、马兵，走山道出击西面，由山朗县出清池县的大盎村，为右支的接应。
清军的战败
西山军士气高昂，趁清军准备欢度春节之机，在除夕夜（即西历1789年1月25日夜）越过涧水（今宁平省与河南省交界的涧渡口）。后黎朝的山南镇守黄冯义毫无防备，大溃。西山军逮捕并杀害了所有清军的斥侯，因此清军无人知晓。
清军从升龙城外至上福河洄一带设置了不少屯堡，堡外埋下震地雷，防卫工事坚固。阮惠在正月初三夜（西历1月28日夜）突然将清军的河洄营（位于今河西省常信县）围得水泄不通，以军筒大声传呼。清军大骇，全部投降，军资器械尽数被西山军缴获。阮惠又于初五日的黎明包围了玉洄垒（位于今河内市清池县）。垒上的清军向下不断开炮，阮惠下令西山军用湿稻草包扎的大木板抵挡清军的枪炮，自己身先士卒，驱象兵攻破了堡垒。攻入玉洄垒后，阮惠命西山军将木板放在地上，用短刀向清军乱砍。清军大溃，四散奔逃。却又触发了震地雷死伤甚众。西山军乘胜连破文典等诸营，清军的提督许世亨、总兵张朝龙、尚维升阵亡于南同屯（今河内市永顺县）。阮惠包围并攻克了升龙城西南方的要塞姜上营（位于今河内市栋多郡），驻守姜上营的田州知府岑宜栋兵败，自缢而死。
黎愍宗得知清军兵败后，带领家小先自逃入镇南关。乌大经所率的云贵兵听见炮声，也在向导黎文通指引下的率军逃归境内。孙士毅与诸将在升龙城内饮酒作乐庆祝新年，毫无防备。得知西山军已攻入升龙城内，惊慌失措，仅仅率领少数的骑兵仓惶向北逃跑。到了富良江边，为了防止西山军的追击，孙士毅下令切断了浮桥。无数清军争相渡河，官兵夫役万余人溺死于河中，珥河之水为之不流。
在得知孙士毅逃归之后，安南境内的清军也全部退回境内。后黎朝遗臣们得知皇帝的逃跑和清军的撤退后，也纷纷逃往清朝境内。皇弟黎维祗欲逃镇南关，为西山军所阻止，遂在谅山起兵反抗，兵败被擒杀。至此清越战争以西山朝的胜利而结束。
结局与后续
乾隆帝得知孙士毅战败后大怒，下令褫夺了之前给予孙士毅一等谋勇公的封号。同时命令福康安代替其职准备继续讨伐安南。福康安得知西山朝强大，欲停止干戈。而阮惠虽然在这场战争中大胜，但他畏惧清朝起倾国之兵前来征讨，于是贿赂福康安，请  阮惠遣阮光显向清朝请和求其上表建议停止出征。另一方面阮惠则以阮光平的名字向清朝请求册封。不久阮惠派遣部将范公治假冒自己前往京师谒见乾隆帝。乾隆帝大喜，当即封阮惠为安南国王。而后黎朝的君主黎愍宗，乾隆帝称他先后两次失去了皇位，说明后黎朝已经被上天唾弃，因此拒绝再支持黎愍宗，并将黎愍宗及其宗室、遗臣迁到京师软禁。
阮惠在议和后试图入侵清朝以报复这次战争，而且阮惠有入侵清朝两广之志向，因此积极准备粮草战船、训练士卒。阮惠试图拉拢中国沿海一带的华南海盗势力，例如郑一、张保仔等著名海盗不少曾被西山朝授予官职。与此同时，阮惠还拉拢反清复明的势力为己所用，例如四川的天地会成员在叛乱后逃到安南，阮惠任命这些人为将领。但不久后的1792年阮惠得病将死，这些计划才被取消。
清朝将清越战争视为乾隆帝的一大功绩，将此列为乾隆帝的“十全武功”之一。清朝人认为乾隆帝以兴亡继绝为名，攻入安南的都城升龙，将黎愍宗重新扶上皇位，将此认为是一功。然而事实上清朝最终在安南惨败，此一功绩与其他九个功绩是不能相比的。