沫雨的小窝

OC 设定卡 · 沫雨

Thu, 15 Oct 2026 00:00:00 GMT

OC 设定卡 · 沫雨#

1. 基本信息#

项	内容
姓名	沫雨
性别	女
年龄	17岁
身高体重	158cm；48kg；
星座	她不知道，也没有人告诉过她
名字来由	「沫」= 水之末、浮沫；「雨」= 落下的水。合起来是一种雨的名字——细到像浮沫，落在人身上不湿衣服。

2. 外观与记忆点#

头发#

半透明的浅青蓝色短发，齐耳、发尾微翘；
左耳后方一小撮翘起、永远干着的呆毛

眼睛#

左眼「贝眼」：瞳孔是珍珠母虹彩（暗银白底，斜光下浮出贝壳内壁的蓝紫—粉绿游色）。对光敏感
右眼「雨眼」：瞳孔积雨云灰。哭前会先变成米白色

服装#

第一原则是防水：米白色短雨披（披肩式）；内穿黑色背带短裙

脚下是一双不合脚、大一码的雨靴

配色#

头发

#A8C6C9头发颜色；#98b8c4头发颜色；#bacdd4头发颜色；

左眼

#8570a0左眼颜色；#e7d8f8 左眼颜色；#8575b9左眼颜色；

右眼

#b0c1db右眼颜色；#c7ddec右眼颜色；#6691c8右眼颜色；

标志性元素#

贝壳——大小不一的贝壳

性格#

OC 设定全流程指南

Sat, 17 Oct 2026 00:00:00 GMT

OC（原创角色）设定全流程指南#

适用范围：原创角色创作、个人 OC、小说/漫画/游戏角色、世界观角色、角色立绘委托与长期设定维护。使用方式：按章节从上到下完成；不必一次填满。先做”能行动、能选择、会变化”的角色，再逐步补充外观、经历与细节。

目录#

OC 设定的核心原则
全流程总览
第一步：确定角色用途与创作边界
第二步：一句话概念与核心卖点
第三步：世界观与角色位置
第四步：身份档案
第五步：外貌与视觉设计
第六步：性格结构
第七步：欲望、需求、恐惧与矛盾
第八步：背景经历与关键事件
第九步：能力、技能与限制
第十步：关系网与互动逻辑
第十一步：日常习惯、偏好与细节
第十二步：角色弧光与剧情功能
第十三步：台词、语气与表达方式
第十四步：视觉参考与立绘需求
第十五步：一致性检查与压力测试
第十六步：整理成正式角色档案
可复制的 OC 设定模板
示例：从概念到完整角色
常见问题与避坑清单
最终检查表

1. OC 设定的核心原则#

OC 是 Original Character（原创角色）的简称。设定不只是”长什么样、喜欢什么、有什么能力”，更重要的是：这个角色为什么会这样想、这样做，以及在不同情境下会怎样选择。

一个容易写活的角色，通常具备以下几层：

辨识度：别人能用一两个特征记住 TA。
内在逻辑：行为背后有原因，性格不是随机拼贴。
欲望与阻碍：TA 想得到某样东西，但并非轻易就能得到。
矛盾性：角色可能嘴硬心软、渴望亲近却害怕依赖，或理性却会为某件事失控。
限制与代价：能力不是万能的，选择也会付出代价。
可变化性：经历会影响 TA，角色可以成长、退步、妥协或彻底改变。
可持续创作：设定能支持日常互动、剧情、关系发展或视觉创作，而不只是一个漂亮的简介。

先记住三条#

先定核心，再补细节。 不要一开始就花几个小时决定袜子的颜色，却不知道角色最想要什么。
设定服务于表达。 每个细节不必都有深层含义，但重要细节最好能帮助塑造角色。
留白是允许的。 不知道的地方可以标为”待定”，不要为了填满表格而硬编。

2. 全流程总览#

建议按以下顺序推进：

明确创作用途和题材。
写出一句话概念。
确定角色在世界中的位置。
建立基础身份档案。
设计外貌、配色、服装和标志物。
建立性格结构和行为逻辑。
确定目标、需求、恐惧和内在矛盾。
设计背景经历与关键事件。
设定能力、弱点、资源和限制。
建立关系网。
补充日常习惯、偏好和小动作。
规划角色弧光或长期变化。
写出台词样本。
整理视觉参考或立绘需求。
进行一致性与场景测试。
整理成正式档案，并保留版本记录。

推荐做法： 第一轮只完成每一项的核心答案；第二轮再扩充细节；第三轮通过具体场景验证设定是否成立。

3. 第一步：确定角色用途与创作边界#

先问自己：这个 OC 是为哪一种创作而存在的？

3.1 用途选择#

主要用于画图、立绘、头像或视觉展示
主要用于小说、漫画或剧本
主要用于跑团、游戏或互动叙事
主要用于角色扮演、聊天或关系互动
主要用于世界观设定
主要是个人喜好与长期陪伴型 OC
其他：__________

用途会影响设定重点。例如，视觉展示型 OC 需要明确的轮廓、配色和标志物；剧情型 OC 需要清楚的目标、冲突和选择逻辑；互动型 OC 则要有稳定的表达习惯与关系边界。

3.2 题材与基调#

填写：

题材：现代 / 奇幻 / 科幻 / 校园 / 悬疑 / 恐怖 / 末世 / 古风 / 其他
整体基调：轻松 / 治愈 / 日常 / 浪漫 / 阴郁 / 残酷 / 荒诞 / 史诗
现实程度：现实主义 / 轻度超现实 / 高幻想 / 完全架空
受众与尺度：全年龄 / 青少年向 / 成人向（涉及敏感内容时需谨慎处理）
角色在故事中的地位：主角 / 配角 / 反派 / 对照角色 / 独立设定
创作边界：哪些内容不想涉及？哪些内容可以探索？

3.3 定义创作目标#

用一到三句话回答：

我为什么想创作这个角色？
我希望别人看到 TA 时，首先感受到什么？
我最想画、写或体验 TA 的哪一面？

产出物： 一张”创作方向卡”。

4. 第二步：一句话概念与核心卖点#

在扩写之前，先用一句话说清楚角色。

4.1 一句话公式#

可以套用：

一个【身份/处境】的【角色类型】，因为【核心欲望或问题】，不得不【行动或面对冲突】；TA 最特别的地方是【反差/独特机制】。

示例：

一个能听见旧物记忆的年轻修复师，为了找回失踪姐姐的线索不断修复遗物，却唯独不敢触碰姐姐留下的最后一件物品。

这句话包含身份、能力、目标、阻碍和情绪钩子，比”神秘、温柔、强大”更能支持后续创作。

4.2 核心卖点拆解#

从以下维度选出最重要的 1---3 项：

外观卖点：浅青绿短发、旧式耳机、总带着透明雨伞。
性格卖点：礼貌疏离，却会记住别人随口提过的小事。
能力卖点：能听见旧物的片段记忆，但无法判断记忆是否真实。
关系卖点：与某人互相依赖，却都不愿承认。
主题卖点：记忆、告别、身份、自由、责任、归属。
反差卖点：外表冷静，遇到小动物就手足无措。

4.3 角色关键词#

选 3 个主要关键词、2 个反差关键词：

主要关键词：__________ / __________ / __________
反差关键词：__________ / __________

避免只写”温柔、强大、神秘、善良”等泛化词。尽量写成可观察的表现，例如”很少主动安慰，但会默默解决对方的问题”。

产出物： 一句话概念 + 五个关键词。

5. 第三步：世界观与角色位置#

角色必须存在于某种环境中。环境决定什么是正常、危险、稀有、违法或值得追求的。

5.1 世界观基础#

时间与地点：__________
社会结构：__________
科技/魔法水平：__________
日常生活方式：__________
主要规则：__________
禁忌与危险：__________
普通人如何看待角色的身份或能力：__________

不需要先创造完整宇宙。只要写清楚会影响角色生活的规则即可。

5.2 角色在社会中的位置#

TA 属于哪个群体？
TA 有什么身份、权限或社会资源？
TA 受到什么制度、传统或环境限制？
TA 是否被误解、被需要、被排斥或被崇拜？
如果 TA 离开当前环境，会失去什么？

5.3 设定规则要能被验证#

例如，若世界中的能力需要付出代价，就要回答：

代价是什么？
谁知道这个规则？
规则有没有例外？
角色能否规避代价？
规避代价会产生什么后果？

产出物： 一页以内的世界观摘要，以及角色在其中的位置。

6. 第四步：身份档案#

基础档案用于快速查阅，不必把所有信息都写成故事。

6.1 基本资料#

姓名：__________
别名 / 绰号：__________
姓名含义与来源：__________
年龄或外表年龄：__________
生日：__________
性别 / 性别表达（如有需要）：__________
代词 / 称呼习惯：__________
种族 / 物种：__________
身高：__________
常住地：__________
职业 / 身份：__________
所属组织：__________
语言：__________
社会身份：__________
当前状态：__________

6.2 名字怎么取#

可以从这些方向寻找灵感：

语义：名字是否与主题、愿望或家族有关？
音感：名字听起来是柔和、锐利、古典还是现代？
文化背景：名字是否符合角色所在地区与时代？
辨识度：是否容易与其他角色混淆？
使用情境：不同人物会如何称呼 TA？全名、昵称、代号是否带有关系差异？

不必强行让名字暗示命运。名字也可以来自家人偏好、时代流行或偶然事件。

6.3 档案中的”确定度”#

为设定标记状态：

确定：已经决定，后续尽量保持一致。
暂定：目前可用，未来可能调整。
待定：还没想好，不影响当前创作。
秘密：角色或读者暂时不知道，但作者有答案。
开放：刻意不定义，留给互动或剧情发展。

产出物： 基础身份表。

7. 第五步：外貌与视觉设计#

视觉设计的目标不是把所有喜欢的元素堆在一起，而是让外貌传达角色的身份、气质与故事。

7.1 从整体轮廓开始#

先不画细节，只用几句话描述剪影：

远远看过去，TA 的轮廓是什么样？
身形偏轻盈、厚重、挺拔、松弛还是不对称？
最容易被认出的部位是什么？
角色站立时习惯挺直、缩肩、重心偏移，还是随时准备行动？

7.2 面部与身体特征#

脸型：圆、长、窄、方、柔和、棱角分明
眼型与眼神：上挑、下垂、圆润、疲惫、锐利、游离
瞳色：主色、辅色、特殊纹理或变化条件
眉毛：浓淡、形状、是否常皱眉
鼻口：整体风格与表情特征
肤色与质感：自然、苍白、雀斑、伤痕、纹路等
发型：长度、层次、发量、刘海、发尾形状
身形：高矮、比例、体态、肌肉量（根据风格需要）
特殊特征：角、尾巴、耳朵、义肢、胎记、纹身、伤疤等

每一个特殊特征最好有设计理由，哪怕只是审美理由。若特征影响生活或行动，也要考虑其实际后果。

7.3 配色方案#

建议先用 3---5 个颜色建立配色系统：

主色：__________
辅色：__________
强调色：__________
中性色：__________
特殊光效色（如适用）：__________

可用 60/30/10 的粗略比例帮助控制画面：主色约占 60%，辅色约占 30%，强调色约占 10%。这不是硬规则，只是避免颜色互相争抢注意力的起点。

配色时检查：

缩小成头像后是否仍有辨识度？
黑白剪影或灰度下是否能分清主要区域？
发色、眼睛、服装是否互相竞争？
配色是否符合角色生活环境与维护条件？

7.4 服装与装备#

不要只写”黑色外套、白色衬衫”。补充服装如何服务角色：

服装风格：__________
主要材质：__________
常穿搭配：__________
工作 / 战斗 / 正式 / 居家服装：__________
穿着习惯：整齐、随意、层叠、偏好宽松或贴身？
服装来源：购买、制服、继承、自己制作、任务配发？
实用性：是否方便移动、隐藏物品、抵御天气？
维护方式：是否会清洗、修补、替换？
标志性配件：__________

7.5 标志物与象征元素#

选择 1---3 个反复出现的视觉元素即可：

物件：耳机、钥匙、旧相机、怀表、纸鹤
图形：水滴、裂纹、月相、羽毛、几何符号
自然意象：雨、雾、海、苔藓、星光、枯枝
质感：玻璃、磨损金属、旧纸、针织布、陶瓷

问自己：它是纯装饰、个人喜好、身份标记、纪念物，还是剧情道具？不同答案都可以，但不要让每件饰品都承载沉重秘密。

7.6 外貌设计简报#

可以这样写给未来的自己或画师：

整体印象：__________
轮廓重点：__________
面部重点：__________
发型与发色：__________
配色：__________
服装结构：__________
标志物：__________
不希望出现的元素：__________
必须保留的特征：__________

产出物： 外貌描述、配色表、服装方案和至少一个可辨识的视觉锚点。

8. 第六步：性格结构#

性格不只是形容词。更有效的写法是说明角色在什么情况下会怎么做。

8.1 表层性格与内在性格#

分别回答：

初次见面时，别人会如何评价 TA？
熟悉之后，别人会发现什么？
TA 自己认为自己是什么样的人？
TA 最不愿承认的性格缺点是什么？

表层和内在不一定相反。例如，一个人可以表里都温柔，但表面礼貌与真正愿意承担责任，是两回事。

8.2 性格维度#

按需要选择，不必每项都写：

外向 / 内向：__________
冲动 / 谨慎：__________
理性 / 感性：__________
直接 / 委婉：__________
信任他人 / 保持戒备：__________
计划型 / 即兴型：__________
竞争型 / 合作型：__________
情绪表达：外露 / 克制 / 延迟爆发 / 难以识别
冲突处理：回避 / 争辩 / 解决问题 / 冷处理 / 寻求第三方

这些维度不是诊断，也不是固定分类，只是帮助观察角色的倾向。

8.3 把形容词转成行为#

抽象形容词可观察的行为

温柔会记住他人的需求，但不一定擅长安慰冷淡很少主动开启话题，却会认真回应具体问题聪明能快速发现规律，但可能忽略情绪因素骄傲不愿求助，失败后更倾向独自练习胆小会预先规划退路，但在关键时刻仍可能行动善良即使没有回报，也会在某些底线上帮助别人控制欲强习惯提前安排细节，面对不确定性时容易焦躁

8.4 性格的边界#

为角色设定：

TA 可以接受什么？
TA 会对什么生气？
什么事情会让 TA 感到羞耻？
TA 在压力下会变得怎样？
TA 对陌生人、朋友、亲密对象、敌人分别有什么表现？
哪种行为会让 TA 彻底失去信任？
TA 有什么优点会在过度使用时变成缺点？

产出物： 3---5 个主要性格特征，每个特征都配一个行为例子。

9. 第七步：欲望、需求、恐惧与矛盾#

这是让角色有动力的核心章节。

9.1 外在目标与内在需求#

外在目标：角色明确想完成的事，例如找到某个人、赢得比赛、偿还债务。
内在需求：角色真正需要学会或接受的事，例如信任他人、承认自己的脆弱、放下控制。
错误信念：角色因为过去经历而相信的某种规则，例如”只要不依赖别人，就不会被抛弃”。
真实问题：这个信念如何限制 TA 的生活？

示例：

外在目标：找到失踪的姐姐。
内在需求：接受自己无法控制所有人的去留。
错误信念：只要收集到足够多的线索，就能避免再次失去亲人。
代价：TA 不愿与活着的人建立关系，把全部时间投入过去。

9.2 恐惧与防御机制#

恐惧不一定是”怕黑、怕虫”。也可以是害怕失去自主权、被看穿、成为负担、被遗忘、无法证明自己。

填写：

TA 最害怕发生什么？
TA 会用什么方式保护自己？
这种保护方式曾经帮过 TA 什么？
现在它又造成了什么问题？
在什么情况下，防御机制会失效？

9.3 内在矛盾公式#

TA 想要【A】，却相信【B】，因此总是做出【C】，结果反而失去【D】。

示例：

TA 想要被理解，却相信暴露弱点会被利用，因此总是假装什么都能处理，结果让真正关心 TA 的人无法靠近。

9.4 道德底线与取舍#

TA 绝不会做什么？
如果为了目标必须越过底线，TA 会怎么选？
TA 可以原谅别人什么？
TA 最不能原谅自己什么？
当两种重要价值发生冲突时，TA 优先保护哪一个？

不要只用”善良”或”邪恶”定义角色。更有意思的是角色在利益、责任、亲情、自由和生存之间如何取舍。

产出物： 外在目标、内在需求、错误信念、恐惧、防御机制、底线。

10. 第八步：背景经历与关键事件#

背景不是把角色从出生到现在的每一天都写出来，而是找出哪些经历真正塑造了现在的 TA。

10.1 时间线结构#

可以按以下阶段写：

早期环境：家庭、照顾者、成长地点、生活资源。
形成期：第一次建立重要信念或习惯的经历。
转折事件：改变生活方向的事件。
后果：事件带来了什么损失、能力、关系或误解？
当前处境：角色现在在追求什么、逃避什么？
未解决的问题：过去仍在影响什么？

10.2 关键事件的五个问题#

每个重要事件至少回答：

发生了什么？
角色当时想要什么？
TA 做了什么选择？
这个选择造成了什么后果？
TA 因此形成了什么信念或习惯？

重点在于”选择和后果”，而不是单纯堆叠悲惨经历。

10.3 背景与性格之间要有连接#

不要写成：

小时候发生了悲剧，所以 TA 很冷漠。

试着具体化：

童年时，TA 多次发现求助并不能及时解决问题，于是习惯先独自处理麻烦。这个习惯让 TA 在紧急情况下很可靠，却也让朋友误以为 TA 不需要帮助。

同一段经历可以产生不同结果。人物的性格还会受到天生气质、后续环境、社会文化和主动选择的影响。

10.4 避免”创伤清单”#

不是每个角色都需要悲惨过去。
创伤不应只是让角色更酷、更强或更有魅力的装饰。
不同经历的影响应有差异，不要把所有问题都归因于一个事件。
角色可以记错、回避、重新理解过去，但要明确这是叙事安排。
给角色留下普通的、快乐的、无关紧要的回忆。

产出物： 3---7 个真正重要的关键事件，以及每件事对当前行为的影响。

11. 第九步：能力、技能与限制#

能力可以是魔法、战斗、知识、社交、观察、修理、烹饪或某种现实技能。非超能力角色同样需要能力设计。

11.1 能力说明卡#

每项重要能力都回答：

能力名称：__________
能做到什么：__________
做不到什么：__________
使用条件：__________
使用成本：__________
风险与副作用：__________
对抗方式：__________
需要怎样训练：__________
角色为什么拥有它：__________
这项能力如何影响日常生活：__________

11.2 用限制创造故事#

限制不等于削弱角色，而是创造选择。例如：

能力需要触碰目标，因此远距离行动困难。
能力使用后会失去短期记忆，因此必须记录信息。
角色非常擅长分析，却无法轻易判断他人的真实意图。
角色有丰富知识，但缺乏实际经验。
角色身体素质很好，却不擅长团队协作。

11.3 平衡检查#

如果角色很强，问：

为什么问题还没有解决？
对手能利用什么弱点？
能力是否有使用条件或代价？
强大的能力是否带来责任、孤独、误解或伦理困境？
角色是否仍需要别人？

如果角色很弱，也问：

TA 有什么独特价值？
TA 能靠什么解决问题？
TA 是否有主动性，而不是只等待别人拯救？

产出物： 1---3 项核心能力，以及明确的边界和代价。

12. 第十步：关系网与互动逻辑#

关系能让角色的不同面向显现出来。一个人在朋友、家人、竞争对手和陌生人面前，可能表现得完全不同。

12.1 关系角色类型#

家人或养育者
朋友与同伴
导师、前辈或学生
竞争对手
敌人或对立阵营
欣赏的人
不愿面对的人
曾经亲近、现在疏远的人
与角色有利益交换的人

这些类型可以重叠。最重要的不是数量，而是每段关系都有不同的互动逻辑。

12.2 关系表#

对象角色对 TA 的感受对方想要什么冲突点关系变化的可能

A 信任但依赖希望角色坦诚角色总是隐瞒问题学会求助 B 尊敬又嫉妒希望获得认可双方竞争同一目标合作或决裂 C 表面敌对希望保护某个秘密双方掌握的信息不同揭露真相

12.3 关系设计的关键问题#

为什么这两个人会相遇？
为什么他们没有立刻离开彼此？
双方分别从关系中得到什么？
双方各自误解了什么？
谁更主动？谁更依赖？这种状态是否会变化？
他们最容易因什么事争吵？
如果关系破裂，真正的原因是什么？
如果关系改善，必须发生什么？

12.4 关系不是单向标签#

“挚友""宿敌""恋人”只是关系名称，不是关系内容。要进一步写出双方如何表达关心、如何争吵、如何道歉、如何试探边界。

产出物： 至少 3 段不同类型的关系；如果是独立展示型 OC，可先留空。

13. 第十一步：日常习惯、偏好与细节#

小细节能让角色从设定表里走出来，但不必把所有内容都写得很有象征意义。

13.1 日常偏好#

喜欢的食物：__________
不喜欢的食物：__________
常喝的饮品：__________
喜欢的天气：__________
喜欢的声音 / 音乐：__________
讨厌的气味或触感：__________
休息方式：__________
兴趣爱好：__________
睡眠习惯：__________
整理物品的方式：__________
消费习惯：__________
手机 / 随身物品里常有什么：__________

13.2 行为小动作#

思考时会做什么？
紧张时会怎样？
说谎时会有什么变化？
开心时如何表现？
生气时是沉默、提高音量还是变得异常礼貌？
面对喜欢的人时会不会改变习惯？
独处时与在人前有什么不同？

13.3 细节的三种用途#

生活感：让角色像一个真实的人。
辨识度：形成容易记住的习惯或物件。
剧情用途：让习惯在关键时刻产生影响。

不要让每一个爱好都和主线有关。角色也可以只是喜欢某种甜点，没什么特别理由。

产出物： 5---10 个日常细节，其中 1---2 个可以成为视觉或互动标志。

14. 第十二步：角色弧光与剧情功能#

如果 OC 会参与故事，考虑 TA 是否会发生变化。若只是用于立绘或日常互动，可以把这一章当作可选项。

14.1 角色弧光结构#

一个简单的变化路径：

当前信念：角色相信什么？
现有策略：TA 如何按照这个信念生活？
遭遇挑战：什么事件证明旧方法不够用？
抵抗变化：为什么 TA 不愿改变？
关键选择：TA 必须放弃或承担什么？
新的理解：TA 学到了什么？
新行动：TA 之后会如何不同地行动？

角色弧光不一定是”变好”。也可以是堕落、固执、重新理解旧信念，或在悲剧中坚持某种价值。

14.2 三种常见弧光#

成长型：放下限制自己的错误信念，形成更成熟的选择方式。
堕落型：为了目标不断合理化越界行为，最终失去原本珍视的东西。
稳定型：角色的核心信念没有改变，但通过行动影响周围人或挑战不合理的环境。

14.3 角色在故事里的功能#

推动事件发生
让主角面对自己的问题
提供不同价值观
揭示世界规则
作为情绪支点
作为对照或镜像
承担喜剧、悬疑、恐怖或其他叙事功能

角色可以有多个功能，但最好先明确最主要的一个。

产出物： 角色起点、关键挑战、最终选择与可能的变化。

15. 第十三步：台词、语气与表达方式#

台词能检验性格是否具体。不要只写”说话温柔”，试着写出句子本身。

15.1 语言特征#

说话速度：快 / 慢 / 有停顿
句子长度：简短 / 绕弯 / 喜欢解释
语气：礼貌 / 直接 / 讽刺 / 平淡 / 热情
常用称呼：__________
口头禅：__________
是否使用俚语、敬语或专业术语：__________
情绪激动时会怎样变化：__________
不擅长表达什么：__________

15.2 同一场景下的台词测试#

请写出角色在以下情境中的反应：

被陌生人夸奖：__________
发现朋友在隐瞒事情：__________
自己犯错：__________
被误解：__________
想向别人求助：__________
试图安慰一个人：__________
遇到讨厌的人：__________
真正开心时：__________

15.3 台词示例对比#

普通台词：

“我很担心你。”

更有角色感的表达可能是：

克制型：“你下次至少留个消息。”
直率型：“你吓死我了！下次不许这样。”
逃避型：”…先把伤口处理了，其他的之后再说。”
嘴硬型：“我只是刚好路过。坐好，别动。”

同一句话可以有多种表达方式。选择最符合角色行为逻辑的版本，而不是一味追求酷或独特。

产出物： 6---8 句代表性台词。

16. 第十四步：视觉参考与立绘需求#

如果准备画图、委托画师或用图像工具生成视觉稿，建议准备一份清晰的视觉简报。

16.1 参考图分类#

轮廓 / 身形参考
发型参考
服装结构参考
材质参考
配色参考
表情参考
姿势与动作参考
场景与光线参考
道具参考

参考图最好标明”参考什么”，例如只参考外套结构，不是要求复制整张图。避免把多个风格完全冲突的参考拼在一起却不说明优先级。

16.2 立绘需要哪些内容#

根据预算和用途选择：

正面全身
侧面 / 背面设定
面部特写
表情差分
服装拆解
道具细节
配色表
身高对比
动作或姿势稿
不同服装版本

16.3 给画师的简报结构#

角色一句话概念
必须保留的视觉特征
外貌与服装描述
配色与材质
表情和姿势
氛围与光线
参考图及每张图的用途
不希望出现的元素
交付尺寸、背景、格式与用途
可自由发挥的部分

产出物： 一份可以直接交给自己、合作伙伴或画师阅读的视觉设计说明。

17. 第十五步：一致性检查与压力测试#

写完设定后，不要只检查有没有填满栏目。让角色进入场景，看看 TA 是否会自然地做出符合逻辑的选择。

17.1 五种压力测试#

测试 A：日常场景

角色一个人度过休息日，会做什么？这能检验生活习惯是否具体。

测试 B：冲突场景

重要的人误解了 TA，TA 会怎么反应？这能检验情绪表达与关系模式。

测试 C：诱惑场景

TA 可以轻松获得目标，但必须违背底线。TA 会怎样选择？这能检验价值观。

测试 D：失败场景

能力失效、计划失败或被拒绝后，TA 会责怪谁、采取什么补救方式？

测试 E：陌生环境

当角色失去资源、身份或熟悉的人时，哪些特征仍然成立？

17.2 一致性检查表#

外貌与职业、生活方式相符，或有合理解释
能力边界明确，没有在需要时突然变成万能
性格特征能转化为具体行为
背景经历与当前习惯之间有可理解的联系
角色有自己的目标，而不是只围绕另一个角色存在
关系中的双方都有动机和选择
优点与缺点会在不同情境下产生不同后果
角色犯错后会承担一定后果
重要设定之间没有互相矛盾
不需要解释的日常细节仍然自然

17.3 发现矛盾时怎么办#

不要急着删掉其中一项。先判断它属于哪一种：

真正矛盾：同一时间、同一条件下无法同时成立。
情境差异：角色对不同的人有不同表现。
内在矛盾：角色言行不一致，这可能正是人物特色。
信息差：角色或读者尚不知道真相。
设定未定：作者还没做最终决定。

只有真正矛盾才必须修正；其他情况可以成为角色层次或剧情伏笔。

产出物： 一份修订清单，记录要修改、保留或暂时开放的问题。

18. 第十六步：整理成正式角色档案#

当核心内容稳定后，把零散笔记整理成方便查阅的文档。

18.1 推荐文档结构#

1
OC名称/
2
├── 00_角色总览.md
3
├── 01_外貌与服装.md
4
├── 02_性格与心理.md
5
├── 03_背景时间线.md
6
├── 04_能力与限制.md
7
├── 05_关系网.md
8
├── 06_台词样本.md
9
├── 07_视觉参考/
10
└── 08_修改记录.md

轻量 OC 不需要拆成这么多文件，一个 Markdown 文档就足够。只有设定量逐渐变大时再拆分。

18.2 总览页写什么#

总览页只放最常用的信息：

一句话概念
角色立绘或代表图
基础身份
3---5 个核心关键词
核心欲望与矛盾
主要能力与限制
最重要的关系
当前剧情状态
设定版本与更新时间

18.3 版本管理#

记录重大变更：

版本修改内容修改原因

v0.1 确定核心概念与外观方向建立初版 v0.2 调整能力限制避免能力过于万能 v1.0 核心设定稳定可以开始正式创作

修改时区分”补充细节”和”推翻核心”。如果更改年龄、背景、能力规则或关系史等重要内容，要检查其他章节是否受到影响。

19. 可复制的 OC 设定模板#

下面的模板可以直接复制到新的 Markdown 文件中。可以先填最有把握的项目，其他项目写”待定”。

1
# 【OC 名称】
2

3
> 一句话概念：
4
> 设定状态：暂定 / 稳定 / 持续更新
5
> 最后更新：YYYY-MM-DD
6

7
## 01. 角色总览
8
- 核心卖点：
9
- 主要关键词：
10
- 反差关键词：
11
- 创作用途：
12
- 题材与基调：
13
- 角色在故事中的功能：
14

15
## 02. 基础身份
16
- 姓名：
17
- 别名 / 绰号：
18
- 名字含义：
19
- 年龄：
20
- 生日：
21
- 性别 / 称呼：
22
- 种族 / 物种：
23
- 身高：
24
- 职业 / 身份：
25
- 所属组织：
26
- 常住地：
27
- 当前状态：
28

29
## 03. 外貌设计
30
- 整体印象：
31
- 轮廓与体态：
32
- 脸型与五官：
33
- 眼睛：
34
- 发型与发色：
35
- 肤色与特殊特征：
36
- 主色：
37
- 辅色：
38
- 强调色：
39
- 常穿服装：
40
- 其他服装：
41
- 标志物：
42
- 必须保留的视觉特征：
43
- 不希望出现的元素：
44

45
## 04. 性格结构
46
- 初见印象：
47
- 熟悉后的真实一面：
48
- 自我认知：
49
- 主要优点：
50
- 主要缺点：
51
- 情绪表达：
52
- 压力反应：
53
- 冲突处理：
54
- 对陌生人：
55
- 对朋友：
56
- 对亲密对象：
57
- 对敌人：
58
- 不能接受的事：
59

60
## 05. 内在驱动力
61
- 外在目标：
62
- 内在需求：
63
- 最大恐惧：
64
- 错误信念：
65
- 防御机制：
66
- 内在矛盾：
67
- 道德底线：
68
- 最珍视的东西：
69
- 最不愿承认的事：
70

71
## 06. 背景经历
72
- 成长环境：
73
- 重要照顾者 / 家庭：
74
- 早期关键事件：
75
- 转折事件：
76
- 重要选择：
77
- 造成的后果：
78
- 形成的信念或习惯：
79
- 当前处境：
80
- 未解决的问题：
81

82
## 07. 能力与限制
83
- 核心能力：
84
- 擅长的技能：
85
- 不擅长的技能：
86
- 使用条件：
87
- 使用代价：
88
- 明确限制：
89
- 弱点：
90
- 可被怎样克制：
91
- 能力对日常生活的影响：
92

93
## 08. 人际关系
94
### 关系 A
95
- 对方是谁：
96
- 角色对对方的感受：
97
- 对方想要什么：
98
- 关系中的冲突：
99
- 双方的误解：
100
- 未来可能的变化：
101

102
### 关系 B
103
- 对方是谁：
104
- 角色对对方的感受：
105
- 对方想要什么：
106
- 关系中的冲突：
107
- 双方的误解：
108
- 未来可能的变化：
109

110
## 09. 日常生活
111
- 喜欢的食物：
112
- 不喜欢的食物：
113
- 喜欢的天气：
114
- 音乐 / 声音偏好：
115
- 兴趣爱好：
116
- 休息方式：
117
- 睡眠习惯：
118
- 常带物品：
119
- 思考时的小动作：
120
- 紧张时的表现：
121
- 开心时的表现：
122
- 生气时的表现：
123
- 一个无特殊含义的小习惯：
124

125
## 10. 语言与台词
126
- 说话速度与句式：
127
- 常用称呼：
128
- 口头禅：
129
- 情绪激动时的变化：
130
- 不擅长表达的内容：
131
- 代表台词 1：
132
- 代表台词 2：
133
- 代表台词 3：
134

135
## 11. 角色变化（可选）
136
- 故事开始时相信什么：
137
- 旧有应对方式：
138
- 迫使 TA 改变的挑战：
139
- TA 最抗拒的变化：
140
- 关键选择：
141
- 可能的成长 / 堕落 / 坚守：
142
- 故事结束时的状态：
143

144
## 12. 设定检查
145
- [ ] 核心概念清晰
146
- [ ] 外貌有辨识度
147
- [ ] 性格可以通过行为表现
148
- [ ] 目标和恐惧明确
149
- [ ] 背景经历影响当前行为
150
- [ ] 能力有限制
151
- [ ] 关系双方都有动机
152
- [ ] 台词符合性格
153
- [ ] 重要设定没有冲突
154
- [ ] 仍有可探索的空间
155

156
## 13. 待定问题
157
-
158
-
159
-
160

161
## 14. 修改记录
162
| 日期 | 修改内容 | 原因 |
163
|---|---|---|
164
| YYYY-MM-DD | 创建初版 | |

展开收起

20. 示例：从概念到完整角色#

以下是一个虚构示例，只用于演示如何把抽象想法落地。

20.1 初始概念#

一个浅青绿色短发、总在雨天出现的旧物修复师，能够听见物品残留的记忆，却无法确认听见的内容是否真实。

这个概念包含了视觉锚点、职业、能力和不确定性。

20.2 核心设定#

姓名：雨森澄（暂定）
年龄：22 岁
职业：旧物修复师
关键词：安静、敏锐、固执
反差：不擅长安慰人，却会认真修好别人舍不得丢弃的小物件
外在目标：找到一件与失踪姐姐有关的旧物
内在需求：接受记忆并不等于事实，也无法替代真正的告别
错误信念：只要把过去拼完整，就能避免再次失去重要的人

20.3 外貌方向#

浅青绿色短发，发尾略微凌乱。
眼睛偏灰绿，眼神常像在观察很远的地方。
服装以灰白、深蓝绿和少量银色为主。
常穿防水外套，随身携带修复工具与旧耳机。
标志物是一把透明伞，但伞柄有明显的修补痕迹。

视觉设计并非每一项都必须象征创伤。透明伞可以只是角色习惯在雨天出门的实用物件；修补痕迹则能自然呼应职业。

20.4 性格如何落到行动#

安静：不急着接话，会先观察对方是否真的需要回应。
敏锐：能发现物件的磨损、修补痕迹和摆放变化。
固执：一旦开始修复，就很难接受”差不多就行”。
不擅长安慰：面对哭泣的人会显得僵硬，但会递纸巾、倒热水，或替对方处理实际问题。

20.5 能力与限制#

能力：触摸旧物时，会听见与它有关的片段声音。
条件：物件必须留有明显使用痕迹；全新物品几乎没有信息。
限制：听到的片段缺乏完整上下文，也可能混入持有者的误解。
代价：长时间使用会让 TA 难以分辨自己的回忆与物品留下的声音。
对抗方式：不同来源的物件可能产生相互矛盾的信息；角色必须通过现实证据验证。

这使能力可以提供线索，却不能直接替代调查。

20.6 关系冲突#

姐姐失踪前留下了一台损坏的录音机。角色迟迟不肯修复它，因为 TA 害怕听到的内容会推翻自己珍藏的记忆。

朋友认为角色是在逃避真相，角色却认为朋友不懂得”有些东西一旦确认，就再也无法挽回”。

双方都不是单纯的对或错：朋友重视事实，角色依靠记忆维持生活。冲突来自价值观差异，而不只是误会。

20.7 角色弧光#

起点：相信收集过去的碎片就能恢复失去的一切。
挑战：听到的记忆与现实证据互相矛盾。
关键选择：继续相信自己最愿意相信的版本，或接受不确定性并面对现实。
可能的变化：角色不再把修复理解为”让一切恢复原样”，而是学会让受损之物带着痕迹继续存在。

20.8 代表台词#

“我可以修好它，但不能保证它会变回原来的样子。”
“那段声音不一定是真的。至少，不一定是完整的。”
“伞给你。我不急着回去。”

20.9 示例的重点#

这个角色不是靠”浅青绿头发 + 雨天 + 神秘能力”就完成了。真正让设定连贯的是：职业、能力限制、错误信念、关系冲突与角色变化彼此呼应。外观有记忆点，内在也有可持续展开的问题。

21. 常见问题与避坑清单#

21.1 设定太多，角色却不鲜明#

原因： 细节很多，但没有核心目标或行为逻辑。
解决： 用一句话概念、三个关键词和一个内在矛盾重新归纳。

21.2 角色全能、没有代价#

原因： 能力只负责解决问题，不会制造新问题。
解决： 明确条件、限制、成本、失败可能与对抗方式。

21.3 角色只有缺点或只有优点#

原因： 性格被写成标签，而不是情境中的选择。
解决： 让优点在过度使用时产生代价，也让缺点在某些情境中有合理来源。

21.4 用悲惨经历替代人物塑造#

原因： 背景事件很多，却没有说明角色如何理解和应对它们。
解决： 每个重要事件都补上选择、后果和当前行为之间的联系。

21.5 为了”有深度”而让所有东西都象征某种创伤#

原因： 角色没有轻松、普通或单纯喜欢的东西。
解决： 保留无特殊含义的偏好与习惯，让角色有普通生活。

21.6 角色只有外观，没有行动动力#

原因： 设定更像一张服装清单。
解决： 至少回答”TA 想要什么、害怕什么、会为此做什么”。

21.7 角色总是围绕另一个角色存在#

原因： 角色没有独立目标。
解决： 即使 TA 很在乎某个人，也要为 TA 设定自己的生活、价值观和选择。

21.8 为了反差而强行矛盾#

原因： 特征之间没有情境或心理连接。
解决： 解释反差出现的条件。例如，角色不是”忽冷忽热”，而是”在工作中高度冷静，面对亲密关系时却害怕失控”。

21.9 一次就想把设定写完#

原因： 把”完整”误解成”每一格都填满”。
解决： 先写可用版本，再通过画图、写场景和互动逐步发现角色。

22. 最终检查表#

完成第一版时，逐项检查：

核心#

我能用一句话介绍这个 OC。
我知道自己为什么想创作 TA。
TA 有至少一个鲜明的辨识点。
TA 不只是几个形容词的组合。

内在#

TA 想得到某样东西。
TA 有恐惧、限制或难以解决的问题。
TA 的选择会产生后果。
TA 至少存在一组有意义的内在矛盾。

外在#

外貌和配色有清晰的重点。
服装与生活方式基本相符。
重要道具或标志物容易识别。
角色在不同姿势和表情下仍然容易辨认。

关系与剧情#

TA 有独立于他人的目标。
重要关系有双方动机。
能力与资源并非无限。
TA 在压力下会做出符合逻辑的选择。

可持续创作#

我能想出至少三个适合 TA 的场景。
我能写出几句符合 TA 语气的台词。
我知道哪些设定已经确定，哪些仍可修改。
我保留了继续探索的空间。

建议的实际创作节奏#

如果不知道从哪里开始，可以按这个顺序分阶段完成：

第 1 轮（15---30 分钟）：用途、题材、一句话概念、三个关键词。
第 2 轮（30---60 分钟）：身份、外貌、配色、标志物。
第 3 轮（30---60 分钟）：性格、目标、恐惧、内在矛盾。
第 4 轮（30---60 分钟）：背景、能力限制、关系网。
第 5 轮（20---40 分钟）：日常习惯、台词、场景测试。
第 6 轮（持续更新）：根据创作反馈修订档案。

时间只是参考，不是任务指标。最重要的是先得到一个能被画出来、写出行动、放进场景中测试的角色。

最后记住：OC 不需要一开始就完美。一个有明确欲望、独特选择和可继续探索空间的角色，比一份填得满满当当却没有行动逻辑的设定表，更容易真正活起来。

Windows 如何装 WSL 教程指南

Sat, 17 Oct 2026 00:00:00 GMT

从零开始，在 Windows 上装一个真正的 Linux。不需要双系统、不需要虚拟机、不需要 U 盘，重启一次就能用。

全文照着复制粘贴命令即可，每一步都标了在哪运行。

在开始之前：WSL 是什么？#

WSL（Windows Subsystem for Linux）是微软官方在 Windows 里内建的 Linux 环境。

你可以把它理解成：Windows 桌面上开了一扇门，门后是一个完整的 Linux 系统。

它能跑真正的 Linux 程序（gcc、python、nginx、docker……）
它能直接读写你 Windows 上的文件
它和 Windows 共享剪贴板、网络、端口
开机即用，几秒启动，不吃多少资源

你为什么需要它？#

场景	在 Windows 上的痛苦	在 WSL 里
学 Python / AI	装包一堆报错、路径各种坑	和服务器环境一模一样
前端开发	npm 依赖在 Windows 上经常出问题	原生 Linux 环境，零折腾
学 Linux 命令	得先装虚拟机	直接就有
部署 / 运维	本地和服务器不一致	完全一致的环境
跑 Docker	Docker Desktop 又重又慢	直接原生跑

Tip

一句话：如果你要跟服务器、开源项目、编程打交道，WSL 是目前 Windows 上最舒服的方案。

第 0 步：确认你的电脑能装#

检查 Windows 版本#

按 Win + R，输入 winver，回车。

Windows 11（任何版本）→ 可以装
Windows 10 → 需要版本号 2004 或更高（内部版本 19041+）
Windows 10 1909 及更早 → 太老，建议先升级系统

也可以按 Win + R → 输入 cmd → 回车，执行：

CMD

1
ver

看到 10.0.19041 以上的数字就行。

检查虚拟化是否开启#

任务管理器（Ctrl + Shift + Esc）→ 点「性能」→ 点「CPU」→ 右下角看：

虚拟化：已启用 ✅

如果是”已禁用”，需要进 BIOS 开启（开机狂按 F2 / Del / F10，找 Intel Virtualization Technology 或 SVM Mode，设为 Enable）。

Note

2015 年后的电脑基本都默认开着虚拟化，大概率你不用管这一步。

第 1 步：安装（一条命令）#

1.1 打开管理员终端#

点开始菜单（或按 Win）
输入 PowerShell
在搜索结果上右键 → 点「以管理员身份运行」

会弹出一个蓝色窗口。这一步很重要 —— 不管理员运行会权限不足。

1.2 执行安装命令#

在蓝色窗口里复制粘贴下面这行，然后回车：

PowerShell（管理员）

1
wsl --install

Tip

在 PowerShell 窗口里直接右键即可粘贴（或者 Ctrl + V）。

它会自动做三件事：

开启「适用于 Linux 的 Windows 子系统」功能
开启「虚拟机平台」功能
下载并安装 Ubuntu（默认发行版，最适合新手）

过程大概几分钟，取决于网速。你会看到进度条。

1.3 重启电脑#

装完它通常会提示重启。必须重启，功能才生效。

PowerShell（管理员）

1
shutdown /r /t 0

如果没自动重启，就手动执行上面这行，或者正常重启一次。

1.4 想装别的发行版？#

默认装的是 Ubuntu。想看看还有哪些可选：

PowerShell

1
wsl --list --online

会列出 Debian、Kali、openSUSE 等。指定安装：

PowerShell

1
wsl --install -d Ubuntu-24.04

Important

推荐新手用 Ubuntu，教程最多、遇到问题最好搜。Debian 更精简，Kali 是安全测试专用，不适合日常开发。

第 2 步：第一次启动，创建账号#

重启之后，Ubuntu 会自动弹出一个黑色窗口（如果没有，就去开始菜单找 Ubuntu 点开）。

第一次启动会初始化，然后让你设置账号：

Ubuntu

1
Installing, this may take a few minutes...
2
Please create a default UNIX user account.
3
Enter new UNIX username: _

输入用户名（小写字母，别用中文和空格）：

Ubuntu

1
Enter new UNIX username: w
2
New password: _

输入密码 —— 然后你会慌，因为屏幕上什么都不显示。

Warning

这是 Linux 的传统：输密码时故意不显示任何字符（连 * 都没有），防止别人看到长度。 你照常输入就行，输完按回车。 别以为键盘坏了。

输两遍确认后，看到类似这样的提示符，就成功了：

Ubuntu

1
w@moyu:~$

🎉 恭喜，你现在有一个 Linux 了。

这个提示符的含义：

1
w      @  moyu   :  ~    $
2
│         │        │    └─ $ 表示普通用户（# 表示管理员）
3
│         │        └─ ~ 表示当前在家目录
4
│         └─ 主机名（你的电脑名）
5
└─ 用户名

第 3 步：换国内软件源（必做）#

Linux 装软件靠 apt，默认从国外服务器下载 —— 在国内会非常慢甚至连不上。换成国内镜像，速度能快几十倍。

在 WSL 的黑色窗口里执行：

WSL

1
sudo cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak
2

3
sudo sed -i 's|http://archive.ubuntu.com|https://mirrors.aliyun.com|g; s|http://security.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list.d/ubuntu.sources

Note

输入 sudo 开头的命令会要你输密码 —— 就是刚才设的那个，同样不显示，输完回车。

然后更新软件列表：

WSL

1
sudo apt update && sudo apt upgrade -y

看到一串下载、最后回到提示符，就 OK 了。

其他可选镜像（挑一个用就行）：

镜像	地址
阿里云	`https://mirrors.aliyun.com/ubuntu`
清华	`https://mirrors.tuna.tsinghua.edu.cn/ubuntu`
中科大	`https://mirrors.ustc.edu.cn/ubuntu`

第 4 步：搞懂文件系统（新手最容易踩的坑）#

Important

这是最重要的一节，很多人在这里浪费时间。

两套文件系统#

位置	路径	说明
Linux 自己的地盘	`/home/w/`、`~/`	速度快，权限正常
Windows 的盘	`/mnt/c/`、`/mnt/d/`	就是你的 C 盘、D 盘

比如你的 Windows 桌面，在 WSL 里是：

WSL

1
cd /mnt/c/Users/你的用户名/Desktop

反过来，在 Windows 上访问 Linux 的文件：

打开「此电脑」，左侧会看到一个 Linux 图标（企鹅 🐧），点进去就是
或者地址栏输入 \\wsl$\Ubuntu-24.04

铁律：项目文件放在 Linux 自己的目录里#

WSL

1
# ✅ 正确 —— 放这里，速度快、权限正常
2
cd ~
3
mkdir myproject
4
cd myproject
5

6
# ❌ 错误 —— 别把项目放 /mnt/c 下跑
7
cd /mnt/c/Users/w/myproject    # 慢很多，还会遇到文件权限 bug

Warning

为什么？ /mnt/c 是网络共享的方式访问 Windows 文件的，大量小文件读写（比如 npm install、编译代码）会慢 5~10 倍，还可能出诡异的权限问题。

日常用法：代码放 Linux 里，用 VS Code 编辑，需要时再复制回 Windows。

第 5 步：装常用工具#

一条命令装上开发中常用的东西：

WSL

1
sudo apt install -y build-essential git curl wget vim unzip zip htop net-tools

分别是：

软件	用途
`build-essential`	C/C++ 编译器，很多软件装的时候要用到
`git`	版本管理，必装
`curl` / `wget`	下载文件、测试接口
`vim`	终端里的文本编辑器
`unzip` / `zip`	压缩解压
`htop`	任务管理器（比 Windows 的还好看）
`net-tools`	`ifconfig` 等网络命令

试试 htop：

WSL

1
htop

按 q 退出。

装 Python 环境（可选但推荐）#

Ubuntu 自带 Python 3。验证一下：

WSL

1
python3 --version

推荐再装个现代的包管理工具 uv（比 pip 快 10~100 倍）：

WSL

1
curl -LsSf https://astral.sh/uv/install.sh | sh

装完重启终端，就可以用 uv 管理 Python 包了。

第 6 步：让 WSL 能上网、能用代理#

6.1 网络模式（新手可以先跳过）#

WSL 默认的 NAT 模式已经能用 —— WSL 有自己的 IP，能正常上网、装软件包。这一节你可以先跳过去，等确实需要时再回来调。

Warning

网上很多教程推荐开「镜像模式」（networkingMode=mirrored）。 但如果你装了 Clash / v2ray 这类本地代理软件，千万别开。 镜像模式的网络初始化依赖 Windows 代理状态，开关一次梯子就可能导致下次启动报错 0x8007054f 并退化成”无网卡”。踩过这个坑的完整记录见排障篇。

如果要用，先建配置文件。在 Windows 上打开「此电脑」→ 地址栏输入 %USERPROFILE% → 回车，在这个文件夹里新建文件 .wslconfig（注意开头有个点）。

Tip

如果提示”必须输入文件名”，用记事本新建：右键 → 新建 → 文本文档 → 重命名为 .wslconfig.（首尾各一个点，Windows 会自动去掉末尾的点）。

稳妥的推荐配置：

.wslconfig展开收起

1
[wsl2]
2

3
# NAT 是默认模式，写不写都一样；关键是别开 autoProxy
4
networkingMode=nat
5
autoProxy=false
6

7
# 通过 Windows 解析 DNS（NAT 下有效，能修不少奇怪的解析失败）
8
dnsTunneling=true
9

10
# 资源限制（按你的电脑配置调整）
11
memory=8GB
12
processors=8
13
swap=4GB
14

15
[experimental]
16

17
# 空闲时把内存还给 Windows
18
autoMemoryReclaim=gradual
19

20
# 防止虚拟磁盘只增不减
21
sparseVhd=true

展开收起

保存后在 PowerShell 里执行（让配置生效）：

PowerShell

1
wsl --shutdown

然后重新打开 Ubuntu，配置就生效了。

6.2 让 WSL 用上梯子#

NAT 模式下 WSL 有独立 IP，127.0.0.1 指的是它自己，够不到 Windows 上的代理。所以要两步：

在你的代理软件里打开「允许局域网连接 / Allow LAN」，让它监听 0.0.0.0:7897 而不只是 127.0.0.1
WSL 里放一段自动探测脚本：

WSL展开收起

1
cat >> ~/.bashrc <<'EOF'
2

3
# ---- WSL proxy (auto-detect) ----
4
wsl_proxy() {
5
    GW=$(ip route show default 2>/dev/null | awk '{print $3}')
6
    if [ -n "$GW" ] && timeout 1 bash -c "</dev/tcp/$GW/7897" 2>/dev/null; then
7
        export http_proxy="http://$GW:7897"
8
        export https_proxy="http://$GW:7897"
9
        export no_proxy="localhost,127.0.0.1,192.168.*,10.*,172.16.*,172.17.*,172.18.*,\
10
172.19.*,172.20.*,172.21.*,172.22.*,172.23.*,172.24.*,172.25.*,172.26.*,172.27.*,\
11
172.28.*,172.29.*,172.30.*,172.31.*,mirrors.aliyun.com,mirrors.tuna.tsinghua.edu.cn"
12
        echo "[proxy] on -> $GW:7897"
13
    else
14
        unset http_proxy https_proxy no_proxy
15
        echo "[proxy] off (梯子没开，国内源直连)"
16
    fi
17
}
18
wsl_proxy
19
EOF
20

21
source ~/.bashrc

展开收起

这段脚本会探测网关的 7897 端口是否可达，梯子开着才启用代理，关了就自动取消。好处是关梯子不会让 WSL 变残废 —— 国内镜像源本来就不需要代理。

验证：

WSL

1
$ curl -sI https://github.com --max-time 10 | head -1
2
HTTP/1.1 200 Connection established     # 梯子开着时

Note

不确定你的代理端口？Windows 上「设置 → 网络和 Internet → 代理」里能看到，一般是 7890 或 7897。脚本里的 7897 换成你自己的端口即可。

Note

如果启动时报 0x8007054f 或”无法配置网络”，说明 Windows 网络栈有问题，管理员 PowerShell 执行 netsh winsock reset + 重启即可。详见排障篇。

第 7 步：装个好用的终端#

系统自带的终端比较朴素。推荐装 Windows Terminal：

打开 Microsoft Store
搜 Windows Terminal
点安装（免费）

装好后它会自动识别你的 Ubuntu，一次开启多个标签页（PowerShell、Ubuntu 并存），支持分屏、主题、字体美化。

Note

Windows 11 其实自带 Windows Terminal，开始菜单搜一下可能已经有了。

第 8 步：用 VS Code 写代码（强烈推荐）#

这是 WSL 最爽的用法之一。

Windows 上正常安装 VS Code
打开 VS Code，装扩展 WSL（搜 WSL，微软官方那个）
在 WSL 终端里，进入你的项目目录，执行：

WSL

1
cd ~/myproject
2
code .

第一次会自动在 WSL 里装 VS Code 服务端，之后就能：

用 Windows 的 VS Code 界面
编辑 Linux 里的文件
终端、调试、Git 全都在 Linux 环境里跑

Tip

这是目前 Windows 上做开发最舒服的组合，强烈建议试试。

第 9 步：开启 systemd（想跑服务的话）#

如果你想在 WSL 里跑 Docker、数据库、SSH 之类的常驻服务，需要开 systemd。

在 WSL 里执行：

WSL

1
sudo tee /etc/wsl.conf > /dev/null <<'EOF'
2
[boot]
3
systemd=true
4
EOF

然后在 PowerShell 里：

PowerShell

1
wsl --shutdown

重新打开 Ubuntu，验证：

WSL

1
systemctl status

能正常显示就说明开了。

常用命令速查#

Windows 端（PowerShell）#

命令	作用
`wsl`	进入默认的 Linux
`wsl ~`	进入并定位到家目录
`wsl -l -v`	列出所有发行版及状态
`wsl --shutdown`	关闭所有 WSL（改配置后必做）
`wsl --update`	更新 WSL 内核
`wsl --status`	查看 WSL 状态
`wsl --list --online`	查看可安装的发行版
`wsl --unregister Ubuntu-24.04`	彻底删除某个发行版（数据全没）
`wsl --export Ubuntu-24.04 backup.tar`	备份
`wsl --import Ubuntu-24.04 D:\wsl backup.tar`	从备份恢复

Linux 端（Ubuntu 窗口）#

命令	作用
`pwd`	我在哪个目录
`ls`	列出当前目录内容
`ls -la`	详细列出（含隐藏文件）
`cd 目录名`	进入目录
`cd ..`	返回上一级
`cd ~`	回家目录
`mkdir 名字`	新建文件夹
`rm -rf 名字`	强制删除（慎用，不进回收站）
`cp a b` / `mv a b`	复制 / 移动
`cat 文件名`	查看文件内容
`sudo 命令`	以管理员身份执行
`apt install 软件名`	装软件
`history`	看历史命令
`clear`	清屏（`Ctrl + L` 同效）
`explorer.exe .`	用 Windows 资源管理器打开当前目录
`code .`	用 VS Code 打开当前目录

常见问题 FAQ#

输密码时屏幕没反应，是不是卡了？#

没有，正常输入即可。Linux 输密码故意不显示任何字符，防止别人看到密码长度。输完回车就行。

`sudo` 提示 “user is not in the sudoers file”？#

说明你用的是 root 或者账号权限有问题。正常创建的账号都能 sudo。如果进了 root（提示符是 #），用 adduser 用户名 再 usermod -aG sudo 用户名 建个新号。

想改默认登录账号？#

在 PowerShell 里：

PowerShell

1
ubuntu2404.exe config --default-user 你的用户名

WSL 太占内存怎么办？#

.wslconfig 里加 memory=4GB（按需要调）。另外 autoMemoryReclaim=gradual 会让空闲内存自动还给 Windows。

不用 WSL 时在 PowerShell 执行 wsl --shutdown 可以完全释放内存。

怎么卸载 WSL？#

PowerShell（管理员）

1
# 删除某个发行版（数据一并删除）
2
wsl --unregister Ubuntu-24.04
3

4
# 完全移除 WSL 功能
5
wsl --shutdown
6
dism.exe /online /disable-feature /featurename:Microsoft-Windows-Subsystem-Linux
7
dism.exe /online /disable-feature /featurename:VirtualMachinePlatform

然后去「设置 → 应用」卸载 Ubuntu 应用。

WSL 里的虚拟硬盘太大，能瘦身吗？#

能。.wslconfig 加 sparseVhd=true 后，再用：

PowerShell（管理员）

1
wsl --shutdown
2
Optimize-VHD -Path "$env:LOCALAPPDATA\Packages\*Ubuntu*\LocalState\ext4.vhdx" -Mode Full

能跑 Linux 图形界面程序吗？#

Windows 11 可以。 直接装了就能用，WSL 会自动转发到 Windows 桌面：

WSL

1
sudo apt install -y gedit
2
gedit

会弹出一个真正的 Linux 窗口应用在 Windows 桌面上。这叫 WSLg。

能跑 Docker 吗？#

两种方案：

装 Docker Desktop，设置里开启 “Use the WSL 2 based engine”（最省事）
在 WSL 里直接装 docker-ce（需要先开 systemd）

新手推荐方案 1。

命令在 PowerShell 里报错”无法识别”？#

Caution

你大概把 Linux 命令粘到 Windows 里了。 ls、cat、grep、head、env 这些在 PowerShell 里不存在。

蓝色窗口（PowerShell）→ 跑 wsl、dism、netsh 这些
黑色窗口（Ubuntu）→ 跑 apt、cd、ls、curl 这些

这是新手最常见的错误，没有之一。

下一步#

现在你有一个能用的 Linux 了。推荐按这个顺序玩下去：

熟悉命令行 —— 试试 ls、cd、pwd、mkdir，别怕，删不坏系统
装 VS Code + WSL 扩展 —— 体验真正的开发环境
跑一个 Python / Node 项目 —— 感受和 Windows 原生开发的差别
学 Git —— git clone 一个开源项目下来跑跑看

遇到问题别慌，错误信息复制去搜，WSL 用户量大，基本都有人踩过。

装不上或者网络出问题？看排障篇，那里记录了六个坑的完整排查过程。

WSL 3.0.3 安装排障实录：从 MSI 损坏到网络崩溃

Sat, 17 Oct 2026 00:00:00 GMT

一次装 WSL，踩了六个坑、绕了五条弯路。真正的原因只有一个，但前面五个”疑似凶手”每一个都看起来很像。

本文记录完整的排查链路、每个阶段的判断依据，以及最后那条一击致命的命令。

Note

如果你只是想装 WSL 还没开始，先看安装教程。这篇是装不上 / 网络不通时的救命文档。

一、环境与目标#

项目	值
系统	Windows 11 Build 26200（25H2）
CPU	13th Gen Intel Core i7-13700H
内存	16 GB
网卡	Intel Wi-Fi 6 AX201（无线连接）
目标	WSL 3.0.3 + Ubuntu 24.04 LTS
初始状态	已装 Store 版 `WindowsSubsystemForLinux 2.5.9.0`，未装任何发行版

先做体检，确认硬件层面没问题：

PowerShell

1
(Get-ComputerInfo).HyperVisorPresent                      # True
2
Get-Service AppXSVC                                        # Running
3
Get-AppxPackage MicrosoftCorporationII.WindowsSubsystemForLinux

虚拟化开着、AppX 部署服务正常、WSL 内核包已存在 —— 只差一个发行版。看起来是顺手的事。

二、坑 1：`Wsl/CallMsi/REGDB_E_CLASSNOTREG`#

现象#

PowerShell（管理员）

1
wsl --install
2
wsl: WSL 安装似乎已损坏 (错误代码： Wsl/CallMsi/Install/REGDB_E_CLASSNOTREG)。
3
按任意键修复 WSL，或 CTRL-C 取消。
4
此提示将在 60 秒后超时。
5
正在更新适用于 Linux 的 Windows 子系统: 3.0.3。

REGDB_E_CLASSNOTREG 即 COM 类未注册，发生在 Store 版 WSL 从 2.5.9 升级到 3.0.3 的 MSI 环节。

Warning

别按任意键。 它的自动修复基本不会成功，只会让你多等 60 秒。直接 CTRL-C 取消。

排查#

AppXSVC（AppX Deployment Service）状态正常，msiserver 是 Manual 按需启动也属正常。所以问题不在服务，而在这条升级链路本身。

解决：绕过 Store，用独立 MSI 安装#

微软在 GitHub Release 上提供完整的离线安装包 —— microsoft/WSL/releases。最新版是 wsl.3.0.3.0.x64.msi（约 351 MB）。

Note

国内直连 GitHub Release 经常中断（curl: (56) schannel: server closed abruptly）。用浏览器或下载工具通常更稳，下载完校验一下大小，351 MB 才完整。

管理员 PowerShell 里执行这套组合拳：

PowerShell（管理员）展开收起

1
# 1. 停掉 WSL 进程
2
Get-Process wsl, wslservice -ErrorAction SilentlyContinue | Stop-Process -Force
3

4
# 2. 卸载损坏的 Store 包（此时未装任何发行版，删它零风险）
5
Get-AppxPackage MicrosoftCorporationII.WindowsSubsystemForLinux | Remove-AppxPackage
6

7
# 3. 清掉失效的 wsl.exe 别名
8
Remove-Item 'HKCU:\Software\Microsoft\Windows\CurrentVersion\App Paths\wsl.exe' -Recurse -Force
9

10
# 4. 用本地 MSI 安装（/passive 显示进度条，/norestart 不自动重启）
11
msiexec /i "C:\Users\w\Downloads\wsl.3.0.3.0.x64.msi" /passive /norestart
12

13
# 5. 确保两个 Windows 功能开着
14
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
15
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

展开收起

msiexec 返回 0 或 3010 都算成功（3010 表示需要重启）。

三、坑 2：`localhost` 代理未镜像#

重启后装发行版，这次很顺利：

PowerShell

1
wsl --install -d Ubuntu-24.04
2
已成功安装分发。可以通过"wsl.exe -d Ubuntu-24.04"启动它
3
wsl: 检测到 localhost 代理配置，但未镜像到 WSL。NAT 模式下的 WSL 不支持 localhost 代理。

创建了 UNIX 用户后进入系统。但那行警告埋下伏笔 —— 本机 Windows 开着系统代理 127.0.0.1:7897，而默认的 NAT 模式里 WSL 是独立 IP，够不到 Windows 的 127.0.0.1。

第一反应：切镜像模式#

镜像模式（mirrored）让 WSL 直接共用 Windows 的网络栈，127.0.0.1 就是 Windows 的 127.0.0.1：

.wslconfig

1
[wsl2]
2
networkingMode=mirrored
3
autoProxy=true

然后就是长达一个小时的噩梦开始。

四、坑 3：`0x8007054f`，WSL 直接退化成无网卡#

PowerShell

1
wsl ~
2
wsl: 出现了内部错误。
3
错误代码： CreateInstance/CreateVm/ConfigureNetworking/0x8007054f
4
wsl: 无法配置网络 (networkingMode Mirrored)，回退到 networkingMode None。

Caution

注意最后那句：回退到 networkingMode None —— 这不是降级，是这台虚拟机连网卡都没有了。后面所有的”网络不通”都源于此。

误判一：以为是 VMware 的锅#

本机装了 VMware，有两张虚拟网卡 VMnet1 / VMnet8：

PowerShell

1
Get-NetAdapter | Where-Object { $_.InterfaceDescription -match 'TUN|TAP|VMware|Hyper-V' }

VMware 的虚拟交换机确实会跟 Hyper-V 抢网络配置，是 mirrored 失败的常见原因。先禁用网卡试：

PowerShell（管理员）

1
Get-NetAdapter -Name "VMware Network Adapter VMnet1","VMware Network Adapter VMnet8" | Disable-NetAdapter -Confirm:$false

仍然报 0x8007054f。

再把 VMware 整个卸载、重启：

PowerShell

1
Get-Service | Where-Object { $_.Name -match 'VMnet|VMWARE|VMAuthd' }   # 空，确认清干净
2
Get-NetAdapter -IncludeHidden                                           # VMnet 已消失

还是报 0x8007054f。

Important

到这里可以确认：VMware 是无辜的。但它背了最久的锅，因为它”看起来最像”。

五、坑 4：NAT 模式下的 IPv6 陷阱#

先回退到 NAT 保命：

.wslconfig

1
[wsl2]
2
networkingMode=nat
3
dnsTunneling=true

网络起来了：

WSL

1
$ ip -4 addr show eth0 | grep inet
2
inet 172.30.7.40/20 brd 172.30.15.255 scope global eth0
3
$ cat /etc/resolv.conf | grep nameserver
4
nameserver 10.255.255.254          # dnsTunneling 的隧道地址，正常

换清华源后 apt update，索引文件全部下载成功，但 deb 包集体失败：

WSL

1
Get:1 https://mirrors.tuna.tsinghua.edu.cn/ubuntu noble InRelease [256 kB]   ← 成功
2
Err:1 ... libgssapi-krb5-2_1.20.1-6ubuntu2.10_amd64.deb
3
  Cannot initiate the connection to mirrors.tuna.tsinghua.edu.cn:443 (2402:f000:1:400::2).
4
  - connect (101: Network is unreachable)

关键线索是那个 IPv6 地址 2402:f000:1:400::2。清华源有 AAAA 记录，apt 优先走 IPv6，而 WSL 的 NAT 网络没有 IPv6 路由 → 直接不可达。

强制 IPv4 即可：

WSL

1
echo 'Acquire::ForceIPv4 "true";' | sudo tee /etc/apt/apt.conf.d/99force-ipv4

同理，curl 在 WSL 里没输出也是这个原因，加 -4 验证：

WSL

1
curl -4 -sI https://mirrors.tuna.tsinghua.edu.cn --max-time 10 | head -1

六、坑 5：IPv6 修好了还是连不上#

加了 ForceIPv4 之后，错误里的 IPv6 地址确实消失了，但换成了：

WSL

1
E: Failed to fetch ... libcurl3t64-gnutls_8.5.0-2ubuntu10.16_amd64.deb
2
  Unable to connect to mirrors.tuna.tsinghua.edu.cn:https:

判断依据#

这一段值得单独说：

dists/ 下的 InRelease（126 ~ 256 KB）全部成功
pool/ 下的 deb 包（几百 KB ~ 几十 MB）大量失败
报错是 Unable to connect（连接建立失败），不是传输中断

如果是 MTU 问题，小文件一样会挂；所以不是 MTU。结合”索引通、包不通”，更像是连接层被掐 —— 后来证实这其实是网络栈损坏的连带症状，而不是源的问题。

又排除了一个：代理软件#

把梯子整个关掉重跑，apt update 照样失败。代理软件无辜。

Note

顺带一个易忽略的点：只退出梯子软件、但 Windows 的”系统代理”开关还开着（ProxyEnable=1 指向 127.0.0.1:7897），会让 Windows 处于半断网状态，WSL 的 dnsTunneling 也会跟着遭殃。关梯子要连开关一起关。

七、阶段性突破：重置 Windows 网络栈#

查 0x8007054f 时确认了两件事：

该错误由 Hyper-V 虚拟交换机与主机物理网卡驱动初始化冲突 触发
社区验证有效的解法是重置 Windows 网络栈

有个低成本试法：先断网（关 Wi-Fi / 拔网线）→ wsl --shutdown → 启动 WSL → 再连网。断网状态下没有物理网卡可绑定，交换机能干净建起来。

但更彻底、一步到位的是这个（管理员 PowerShell，需重启）：

PowerShell（管理员）

1
wsl --shutdown
2
net stop hns
3
net start hns
4
netsh winsock reset
5
netsh int ip reset
6
shutdown /r /t 0

重启后再进 WSL —— 报错消失了。

WSL

1
$ hostname -I
2
192.168.1.112 fd8e:133f:b5f7:0:bd12:a5a:7ee2:e51d ...   # 与 Windows 同网段 + IPv6 都回来了
3
$ sudo apt update
4
Fetched 3227 kB in 1s (4548 kB/s)                        # 一次成功

镜像模式正常，代理自动同步，IPv6 可用，apt 跑满速。

当时以为故事到此结束。并没有 —— 第二天它又崩了，而且崩得一模一样。

八、反转：真凶其实是代理软件#

复现规律是用户自己发现的：

使用途中如果开了代理再关掉，就会弹窗提示重启 WSL，重启之后还是报 0x8007054f。

这条线索一下子把前面所有矛盾都解释了 —— 那天 winsock reset 之后之所以成功，是因为那次启动代理还没打开。

证据#

查进程确认本机跑的是 Clash Verge：

PowerShell

1
Get-Process | Where-Object { $_.ProcessName -match 'clash|mihomo|verge|sing|v2ray' }

1
 3532 clash-verge         D:\Program Files\Clash Verge\clash-verge.exe
2
27320 verge-mihomo        D:\Program Files\Clash Verge\verge-mihomo.exe

再看网卡，WSL 的那张 vEthernet (WSL (Hyper-V firewall)) 不见了，多出来一对陌生组件：

PowerShell

1
Get-NetAdapter -IncludeHidden | Where-Object { $_.InterfaceDescription -match 'Hyper-V|WSL' }

1
Name                     InterfaceDescription                       Status
2
----                     --------------------                       ------
3
vEthernet (FSE HostVnic) Hyper-V Virtual Ethernet Container Adapter Up
4
vSwitch (FSE Switch)     Hyper-V Virtual Switch Extension Adapter   Up

代理软件运行时会改 Windows 代理状态、并往 Hyper-V 网络栈里插入自己的组件。 而镜像模式的网络初始化恰恰依赖这份状态 —— 开关一次，状态就不一致了，下次 WSL 起不来。

Warning

结论：只要 Windows 上装了本地代理客户端，镜像模式就不稳定。 这不是配置问题，是架构冲突。查资料时其实早就看到这句话（“只要你在 Windows 开了本地代理，WSL Mirrored 网络就极易报这个错”），当时没当回事。

最终架构：NAT + 自动探测代理#

既然会频繁开关梯子，那就彻底不用镜像模式。NAT 不读 Windows 代理状态，开关梯子对它毫无影响。

代价是 NAT 下 127.0.0.1 够不到 Windows 的代理，得绕一下：

Clash Verge 里打开「允许局域网连接 / Allow LAN」，让它监听 0.0.0.0:7897 而不只是 127.0.0.1
WSL 里放一段自动探测脚本，梯子开着才走代理，关了自动降级：

WSL展开收起

1
cat >> ~/.bashrc <<'EOF'
2

3
# ---- WSL proxy (auto-detect) ----
4
wsl_proxy() {
5
    GW=$(ip route show default 2>/dev/null | awk '{print $3}')
6
    if [ -n "$GW" ] && timeout 1 bash -c "</dev/tcp/$GW/7897" 2>/dev/null; then
7
        export http_proxy="http://$GW:7897"
8
        export https_proxy="http://$GW:7897"
9
        export no_proxy="localhost,127.0.0.1,192.168.*,10.*,172.16.*,172.17.*,172.18.*,\
10
172.19.*,172.20.*,172.21.*,172.22.*,172.23.*,172.24.*,172.25.*,172.26.*,172.27.*,\
11
172.28.*,172.29.*,172.30.*,172.31.*,mirrors.aliyun.com,mirrors.tuna.tsinghua.edu.cn"
12
        echo "[proxy] on -> $GW:7897"
13
    else
14
        unset http_proxy https_proxy no_proxy
15
        echo "[proxy] off (梯子没开，国内源直连)"
16
    fi
17
}
18
wsl_proxy
19
EOF
20

21
source ~/.bashrc

展开收起

脚本用 /dev/tcp 探测网关的 7897 是否可达：开着就 export，关着就 unset。这样就不会出现”关了梯子导致 WSL 半瘫”的情况 —— 国内源本来也不需要代理。

Tip

不想开 Allow LAN 的话，Windows 侧改用端口转发也行（管理员 PowerShell）：

Terminal window

1
netsh interface portproxy add v4tov4 listenaddress=<WSL网关IP> listenport=7897 connectaddress=127.0.0.1 connectport=7897

只监听网关地址，比 0.0.0.0 安全，代价是 WSL 网段变了要重配。

九、最终配置#

C:\Users\<你>\.wslconfig：

.wslconfig展开收起

1
[wsl2]
2

3
# --- 为什么不用 mirrored ---
4
# 镜像模式初始化网络时依赖 Windows 代理状态，本机跑 Clash Verge，
5
# 每次开关梯子都会让下一次 WSL 启动报 0x8007054f 并回退 None。
6
# 结论：有本地代理客户端时，镜像模式不可用。
7
networkingMode=nat
8

9
# 必须关：NAT 模式下读取 Windows 代理只会每启动一次的无效警告
10
autoProxy=false
11

12
# 通过 Windows 解析 DNS，而不是走 NAT 网关
13
dnsTunneling=true
14

15
# 资源限制（i7-13700H / 16GB），按需调整
16
# 不设的话 WSL 会吃掉约一半内存和全部核心
17
memory=8GB
18
processors=8
19
swap=4GB
20

21
[experimental]
22

23
# 空闲时把缓存内存还给 Windows
24
autoMemoryReclaim=gradual
25

26
# 阻止 ext4.vhdx 只增不减
27
sparseVhd=true

展开收起

apt 源（/etc/apt/sources.list.d/ubuntu.sources）：

/etc/apt/sources.list.d/ubuntu.sources

1
Types: deb
2
URIs: https://mirrors.aliyun.com/ubuntu
3
Suites: noble noble-updates noble-backports noble-security
4
Components: main restricted universe multiverse
5
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

梯子开着时验证（注意这里是网关 IP 而不是 127.0.0.1，NAT 下 WSL 是独立 IP）：

WSL

1
$ ip route show default | awk '{print $3}'
2
172.30.0.1
3

4
$ env | grep -i proxy
5
http_proxy=http://172.30.0.1:7897
6
https_proxy=http://172.30.0.1:7897
7
no_proxy=localhost,127.0.0.1,192.168.*,10.*,...,mirrors.aliyun.com   # 内网自动绕过
8

9
$ curl -sI https://github.com --max-time 10 | head -1
10
HTTP/1.1 200 Connection established

梯子关掉后重开一个终端：

WSL

1
[proxy] off (梯子没开，国内源直连)
2
$ curl -sI https://mirrors.aliyun.com --max-time 10 | head -1
3
HTTP/2 200                            # 国内源照常能通，只是 GitHub 不通而已

十、速查表：错误码 → 处置#

错误	含义	处置
`Wsl/CallMsi/REGDB_E_CLASSNOTREG`	Store 版升级时 MSI 注册失败	下载独立 MSI 手动装；先卸 Appx 包
`CreateInstance/CreateVm/ConfigureNetworking/0x8007054f`	本机是代理客户端所致；其他机器多为网络栈损坏	装了 Clash 类软件就直接切 NAT；否则 `netsh winsock reset`
`回退到 networkingMode None`	虚拟机无网卡，一切网络问题的根源	见上
`connect (101: Network is unreachable)` + IPv6 地址	NAT 下无 IPv6 路由	`Acquire::ForceIPv4 "true"`
`Temporary failure resolving 'xxx'`	DNS 不通	多为上层问题的表象，别只改 DNS
`检测到 localhost 代理配置，但未镜像`	NAT 下用不了 Windows 代理	无害。要代理就开 Allow LAN + 网关 IP，或 portproxy 转发

Tip

推荐排查顺序（能省两小时）：

装了本地代理客户端（Clash / v2ray 类）就别用 mirrored，直接改 NAT
netsh winsock reset + netsh int ip reset + 重启
net stop hns / net start hns
再怀疑 VMware / VPN / 杀毒软件的 NDIS 驱动
最后才去换源、调 apt 参数

十一、复盘#

怀疑对象	处置	结论
WSL 安装包损坏	独立 MSI 重装	✅ 确实是问题，已解决
IPv6 路由缺失	`ForceIPv4`	⚠️ 只是表象
清华源 / 并发连接	换阿里云源	⚠️ 只是表象
VMware 虚拟网卡	禁用 → 卸载 → 重启	❌ 全部无效
Windows 网络栈损坏	`winsock reset`	⚠️ 暂时有效，第二天复发
本地代理客户端（Clash Verge）	切 NAT + 自动探测代理	✅ 真凶

四条教训：

表象会骗人。 IPv6、镜像源、并发数 —— 每一个都能自圆其说，但都不是根因。真正有效的判断方式是看哪些成功、哪些失败：索引能下、包不能下，这个组合指向底层网络栈而非应用层配置。
“修好了”不等于”修对了”。 winsock reset 之后一切正常，我当场下了结论。区别在哪？那次启动代理还没开。一个修复恰好绕开了真正的触发条件，看起来就像是修好了 —— 这种假成功最危险。
复现规律比日志值钱。 最后破案靠的是用户一句话：“开关代理之后就会崩”。这条规律直接指向了因果关系，比任何错误码都准确。所以排查时要多问一句：什么情况下会出现？什么情况下不会？
分清楚命令在哪边跑。 全程最大的低级失误是把 curl ... | head -1、env | grep 之类的 Linux 命令粘进了 PowerShell。head、env、grep 在 Windows 上不存在 —— 给命令时务必标注「Windows 端」还是「WSL 端」。

附：一键修复脚本#

fix-wsl.ps1（管理员运行），处理坑 1 的 MSI 损坏：

PowerShell（管理员）

1
Set-ExecutionPolicy -Scope Process Bypass -Force
2
& ".\fix-wsl.ps1" -MsiPath "C:\Users\w\Downloads\wsl.3.0.3.0.x64.msi"

脚本依次执行：停进程 → 卸载损坏 Appx → 清 wsl.exe 别名 → 本地 MSI 安装 → 启用 Windows 功能 → 提示重启。

环境：Windows 11 Build 26200 / WSL 3.0.3 / Ubuntu 24.04 LTS

还没装上？看安装教程从零开始。