| 项 | 内容 |
|---|---|
| 姓名 | 沫雨 |
| 性别 | 女 |
| 年龄 | 17岁 |
| 身高体重 | 158cm；48kg； |
| 星座 | 她不知道，也没有人告诉过她 |
| 名字来由 | 「沫」= 水之末、浮沫；「雨」= 落下的水。合起来是一种雨的名字——细到像浮沫，落在人身上不湿衣服。 |
第一原则是防水：米白色短雨披（披肩式）；内穿黑色背带短裙
脚下是一双不合脚、大一码的雨靴
头发
#A8C6C9头发颜色 ；#98b8c4头发颜色 ；#bacdd4头发颜色 ；
左眼
#8570a0左眼颜色；#e7d8f8 左眼颜色 ；#8575b9左眼颜色；
右眼
#b0c1db右眼颜色；#c7ddec右眼颜色；#6691c8右眼颜色；
适用范围：原创角色创作、个人 OC、小说/漫画/游戏角色、世界观角色、角色立绘委托与长期设定维护。 使用方式：按章节从上到下完成；不必一次填满。先做”能行动、能选择、会变化”的角色，再逐步补充外观、经历与细节。
OC 是 Original Character（原创角色）的简称。设定不只是”长什么样、喜欢什么、有什么能力”，更重要的是：这个角色为什么会这样想、这样做，以及在不同情境下会怎样选择。
一个容易写活的角色，通常具备以下几层：
建议按以下顺序推进：
推荐做法： 第一轮只完成每一项的核心答案；第二轮再扩充细节；第三轮通过具体场景验证设定是否成立。
先问自己：这个 OC 是为哪一种创作而存在的？
用途会影响设定重点。例如，视觉展示型 OC 需要明确的轮廓、配色和标志物；剧情型 OC 需要清楚的目标、冲突和选择逻辑；互动型 OC 则要有稳定的表达习惯与关系边界。
填写：
用一到三句话回答：
产出物： 一张”创作方向卡”。
在扩写之前，先用一句话说清楚角色。
可以套用：
一个【身份/处境】的【角色类型】，因为【核心欲望或问题】，不得不【行动或面对冲突】；TA 最特别的地方是【反差/独特机制】。
示例：
一个能听见旧物记忆的年轻修复师，为了找回失踪姐姐的线索不断修复遗物，却唯独不敢触碰姐姐留下的最后一件物品。
这句话包含身份、能力、目标、阻碍和情绪钩子，比”神秘、温柔、强大”更能支持后续创作。
从以下维度选出最重要的 1---3 项：
选 3 个主要关键词、2 个反差关键词：
避免只写”温柔、强大、神秘、善良”等泛化词。尽量写成可观察的表现，例如”很少主动安慰，但会默默解决对方的问题”。
产出物： 一句话概念 + 五个关键词。
角色必须存在于某种环境中。环境决定什么是正常、危险、稀有、违法或值得追求的。
不需要先创造完整宇宙。只要写清楚会影响角色生活的规则即可。
例如，若世界中的能力需要付出代价，就要回答：
产出物： 一页以内的世界观摘要，以及角色在其中的位置。
基础档案用于快速查阅，不必把所有信息都写成故事。
可以从这些方向寻找灵感：
不必强行让名字暗示命运。名字也可以来自家人偏好、时代流行或偶然事件。
为设定标记状态：
产出物： 基础身份表。
视觉设计的目标不是把所有喜欢的元素堆在一起，而是让外貌传达角色的身份、气质与故事。
先不画细节，只用几句话描述剪影：
每一个特殊特征最好有设计理由，哪怕只是审美理由。若特征影响生活或行动，也要考虑其实际后果。
建议先用 3---5 个颜色建立配色系统：
可用 60/30/10 的粗略比例帮助控制画面：主色约占 60%，辅色约占 30%，强调色约占 10%。这不是硬规则，只是避免颜色互相争抢注意力的起点。
配色时检查：
不要只写”黑色外套、白色衬衫”。补充服装如何服务角色：
选择 1---3 个反复出现的视觉元素即可：
问自己：它是纯装饰、个人喜好、身份标记、纪念物，还是剧情道具？不同答案都可以，但不要让每件饰品都承载沉重秘密。
可以这样写给未来的自己或画师：
整体印象：__________
轮廓重点：__________
面部重点：__________
发型与发色：__________
配色：__________
服装结构：__________
标志物：__________
不希望出现的元素：__________
必须保留的特征：__________
产出物： 外貌描述、配色表、服装方案和至少一个可辨识的视觉锚点。
性格不只是形容词。更有效的写法是说明角色在什么情况下会怎么做。
分别回答：
表层和内在不一定相反。例如，一个人可以表里都温柔，但表面礼貌与真正愿意承担责任，是两回事。
按需要选择，不必每项都写：
这些维度不是诊断，也不是固定分类，只是帮助观察角色的倾向。
抽象形容词 可观察的行为
温柔 会记住他人的需求，但不一定擅长安慰 冷淡 很少主动开启话题，却会认真回应具体问题 聪明 能快速发现规律，但可能忽略情绪因素 骄傲 不愿求助，失败后更倾向独自练习 胆小 会预先规划退路，但在关键时刻仍可能行动 善良 即使没有回报，也会在某些底线上帮助别人 控制欲强 习惯提前安排细节，面对不确定性时容易焦躁
为角色设定：
产出物： 3---5 个主要性格特征，每个特征都配一个行为例子。
这是让角色有动力的核心章节。
示例：
恐惧不一定是”怕黑、怕虫”。也可以是害怕失去自主权、被看穿、成为负担、被遗忘、无法证明自己。
填写：
TA 想要【A】，却相信【B】，因此总是做出【C】，结果反而失去【D】。
示例：
TA 想要被理解，却相信暴露弱点会被利用，因此总是假装什么都能处理，结果让真正关心 TA 的人无法靠近。
不要只用”善良”或”邪恶”定义角色。更有意思的是角色在利益、责任、亲情、自由和生存之间如何取舍。
产出物： 外在目标、内在需求、错误信念、恐惧、防御机制、底线。
背景不是把角色从出生到现在的每一天都写出来，而是找出哪些经历真正塑造了现在的 TA。
可以按以下阶段写：
每个重要事件至少回答：
重点在于”选择和后果”，而不是单纯堆叠悲惨经历。
不要写成：
小时候发生了悲剧，所以 TA 很冷漠。
试着具体化：
童年时，TA 多次发现求助并不能及时解决问题，于是习惯先独自处理麻烦。这个习惯让 TA 在紧急情况下很可靠，却也让朋友误以为 TA 不需要帮助。
同一段经历可以产生不同结果。人物的性格还会受到天生气质、后续环境、社会文化和主动选择的影响。
产出物： 3---7 个真正重要的关键事件，以及每件事对当前行为的影响。
能力可以是魔法、战斗、知识、社交、观察、修理、烹饪或某种现实技能。非超能力角色同样需要能力设计。
每项重要能力都回答：
限制不等于削弱角色，而是创造选择。例如：
如果角色很强，问：
如果角色很弱，也问：
产出物： 1---3 项核心能力，以及明确的边界和代价。
关系能让角色的不同面向显现出来。一个人在朋友、家人、竞争对手和陌生人面前，可能表现得完全不同。
这些类型可以重叠。最重要的不是数量，而是每段关系都有不同的互动逻辑。
对象 角色对 TA 的感受 对方想要什么 冲突点 关系变化的可能
A 信任但依赖 希望角色坦诚 角色总是隐瞒问题 学会求助 B 尊敬又嫉妒 希望获得认可 双方竞争同一目标 合作或决裂 C 表面敌对 希望保护某个秘密 双方掌握的信息不同 揭露真相
“挚友""宿敌""恋人”只是关系名称，不是关系内容。要进一步写出双方如何表达关心、如何争吵、如何道歉、如何试探边界。
产出物： 至少 3 段不同类型的关系；如果是独立展示型 OC，可先留空。
小细节能让角色从设定表里走出来，但不必把所有内容都写得很有象征意义。
不要让每一个爱好都和主线有关。角色也可以只是喜欢某种甜点，没什么特别理由。
产出物： 5---10 个日常细节，其中 1---2 个可以成为视觉或互动标志。
如果 OC 会参与故事，考虑 TA 是否会发生变化。若只是用于立绘或日常互动，可以把这一章当作可选项。
一个简单的变化路径：
角色弧光不一定是”变好”。也可以是堕落、固执、重新理解旧信念，或在悲剧中坚持某种价值。
角色可以有多个功能，但最好先明确最主要的一个。
产出物： 角色起点、关键挑战、最终选择与可能的变化。
台词能检验性格是否具体。不要只写”说话温柔”，试着写出句子本身。
请写出角色在以下情境中的反应：
普通台词：
“我很担心你。”
更有角色感的表达可能是：
同一句话可以有多种表达方式。选择最符合角色行为逻辑的版本，而不是一味追求酷或独特。
产出物： 6---8 句代表性台词。
如果准备画图、委托画师或用图像工具生成视觉稿，建议准备一份清晰的视觉简报。
参考图最好标明”参考什么”，例如只参考外套结构，不是要求复制整张图。避免把多个风格完全冲突的参考拼在一起却不说明优先级。
根据预算和用途选择：
产出物： 一份可以直接交给自己、合作伙伴或画师阅读的视觉设计说明。
写完设定后，不要只检查有没有填满栏目。让角色进入场景，看看 TA 是否会自然地做出符合逻辑的选择。
测试 A：日常场景
角色一个人度过休息日，会做什么？这能检验生活习惯是否具体。
测试 B：冲突场景
重要的人误解了 TA，TA 会怎么反应？这能检验情绪表达与关系模式。
测试 C：诱惑场景
TA 可以轻松获得目标，但必须违背底线。TA 会怎样选择？这能检验价值观。
测试 D：失败场景
能力失效、计划失败或被拒绝后，TA 会责怪谁、采取什么补救方式？
测试 E：陌生环境
当角色失去资源、身份或熟悉的人时，哪些特征仍然成立？
不要急着删掉其中一项。先判断它属于哪一种：
只有真正矛盾才必须修正；其他情况可以成为角色层次或剧情伏笔。
产出物： 一份修订清单，记录要修改、保留或暂时开放的问题。
当核心内容稳定后，把零散笔记整理成方便查阅的文档。
1OC名称/2├── 00_角色总览.md3├── 01_外貌与服装.md4├── 02_性格与心理.md5├── 03_背景时间线.md6├── 04_能力与限制.md7├── 05_关系网.md8├── 06_台词样本.md9├── 07_视觉参考/10└── 08_修改记录.md轻量 OC 不需要拆成这么多文件，一个 Markdown 文档就足够。只有设定量逐渐变大时再拆分。
总览页只放最常用的信息：
记录重大变更：
版本 修改内容 修改原因
v0.1 确定核心概念与外观方向 建立初版 v0.2 调整能力限制 避免能力过于万能 v1.0 核心设定稳定 可以开始正式创作
修改时区分”补充细节”和”推翻核心”。如果更改年龄、背景、能力规则或关系史等重要内容，要检查其他章节是否受到影响。
下面的模板可以直接复制到新的 Markdown 文件中。可以先填最有把握的项目，其他项目写”待定”。
1# 【OC 名称】2
3> 一句话概念：4> 设定状态：暂定 / 稳定 / 持续更新5> 最后更新：YYYY-MM-DD6
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### 关系 A95- 对方是谁：96- 角色对对方的感受：97- 对方想要什么：98- 关系中的冲突：99- 双方的误解：100- 未来可能的变化：101
102### 关系 B103- 对方是谁：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 | 创建初版 | |以下是一个虚构示例，只用于演示如何把抽象想法落地。
一个浅青绿色短发、总在雨天出现的旧物修复师，能够听见物品残留的记忆，却无法确认听见的内容是否真实。
这个概念包含了视觉锚点、职业、能力和不确定性。
视觉设计并非每一项都必须象征创伤。透明伞可以只是角色习惯在雨天出门的实用物件；修补痕迹则能自然呼应职业。
这使能力可以提供线索，却不能直接替代调查。
姐姐失踪前留下了一台损坏的录音机。角色迟迟不肯修复它，因为 TA 害怕听到的内容会推翻自己珍藏的记忆。
朋友认为角色是在逃避真相，角色却认为朋友不懂得”有些东西一旦确认，就再也无法挽回”。
双方都不是单纯的对或错：朋友重视事实，角色依靠记忆维持生活。冲突来自价值观差异，而不只是误会。
这个角色不是靠”浅青绿头发 + 雨天 + 神秘能力”就完成了。真正让设定连贯的是：职业、能力限制、错误信念、关系冲突与角色变化彼此呼应。外观有记忆点，内在也有可持续展开的问题。
原因： 细节很多，但没有核心目标或行为逻辑。
解决： 用一句话概念、三个关键词和一个内在矛盾重新归纳。
原因： 能力只负责解决问题，不会制造新问题。
解决： 明确条件、限制、成本、失败可能与对抗方式。
原因： 性格被写成标签，而不是情境中的选择。
解决： 让优点在过度使用时产生代价，也让缺点在某些情境中有合理来源。
原因： 背景事件很多，却没有说明角色如何理解和应对它们。
解决： 每个重要事件都补上选择、后果和当前行为之间的联系。
原因： 角色没有轻松、普通或单纯喜欢的东西。
解决： 保留无特殊含义的偏好与习惯，让角色有普通生活。
原因： 设定更像一张服装清单。
解决： 至少回答”TA 想要什么、害怕什么、会为此做什么”。
原因： 角色没有独立目标。
解决： 即使 TA 很在乎某个人，也要为 TA
设定自己的生活、价值观和选择。
原因： 特征之间没有情境或心理连接。
解决：
解释反差出现的条件。例如，角色不是”忽冷忽热”，而是”在工作中高度冷静，面对亲密关系时却害怕失控”。
原因： 把”完整”误解成”每一格都填满”。
解决： 先写可用版本，再通过画图、写场景和互动逐步发现角色。
完成第一版时，逐项检查：
如果不知道从哪里开始，可以按这个顺序分阶段完成：
时间只是参考，不是任务指标。最重要的是先得到一个能被画出来、写出行动、放进场景中测试的角色。
最后记住：OC 不需要一开始就完美。一个有明确欲望、独特选择和可继续探索空间的角色，比一份填得满满当当却没有行动逻辑的设定表，更容易真正活起来。
全文照着复制粘贴命令即可，每一步都标了在哪运行。
WSL（Windows Subsystem for Linux）是微软官方在 Windows 里内建的 Linux 环境。
你可以把它理解成：Windows 桌面上开了一扇门，门后是一个完整的 Linux 系统。
| 场景 | 在 Windows 上的痛苦 | 在 WSL 里 |
|---|---|---|
| 学 Python / AI | 装包一堆报错、路径各种坑 | 和服务器环境一模一样 |
| 前端开发 | npm 依赖在 Windows 上经常出问题 | 原生 Linux 环境，零折腾 |
| 学 Linux 命令 | 得先装虚拟机 | 直接就有 |
| 部署 / 运维 | 本地和服务器不一致 | 完全一致的环境 |
| 跑 Docker | Docker Desktop 又重又慢 | 直接原生跑 |
一句话：如果你要跟服务器、开源项目、编程打交道，WSL 是目前 Windows 上最舒服的方案。
按 Win + R，输入 winver，回车。
也可以按 Win + R → 输入 cmd → 回车，执行：
1ver看到 10.0.19041 以上的数字就行。
任务管理器（Ctrl + Shift + Esc）→ 点「性能」→ 点「CPU」→ 右下角看：
虚拟化：已启用 ✅
如果是”已禁用”，需要进 BIOS 开启（开机狂按 F2 / Del / F10，找 Intel Virtualization Technology 或 SVM Mode，设为 Enable）。
2015 年后的电脑基本都默认开着虚拟化，大概率你不用管这一步。
Win）PowerShell会弹出一个蓝色窗口。这一步很重要 —— 不管理员运行会权限不足。
在蓝色窗口里复制粘贴下面这行，然后回车：
1wsl --install在 PowerShell 窗口里直接右键即可粘贴（或者 Ctrl + V）。
它会自动做三件事：
过程大概几分钟，取决于网速。你会看到进度条。
装完它通常会提示重启。必须重启，功能才生效。
1shutdown /r /t 0如果没自动重启，就手动执行上面这行，或者正常重启一次。
默认装的是 Ubuntu。想看看还有哪些可选：
1wsl --list --online会列出 Debian、Kali、openSUSE 等。指定安装：
1wsl --install -d Ubuntu-24.04推荐新手用 Ubuntu，教程最多、遇到问题最好搜。Debian 更精简，Kali 是安全测试专用，不适合日常开发。
重启之后，Ubuntu 会自动弹出一个黑色窗口（如果没有，就去开始菜单找 Ubuntu 点开）。
第一次启动会初始化，然后让你设置账号：
1Installing, this may take a few minutes...2Please create a default UNIX user account.3Enter new UNIX username: _输入用户名（小写字母，别用中文和空格）：
1Enter new UNIX username: w2New password: _输入密码 —— 然后你会慌，因为屏幕上什么都不显示。
这是 Linux 的传统：输密码时故意不显示任何字符（连 * 都没有），防止别人看到长度。
你照常输入就行，输完按回车。 别以为键盘坏了。
输两遍确认后，看到类似这样的提示符，就成功了：
1w@moyu:~$🎉 恭喜，你现在有一个 Linux 了。
这个提示符的含义：
1w @ moyu : ~ $2│ │ │ └─ $ 表示普通用户（# 表示管理员）3│ │ └─ ~ 表示当前在家目录4│ └─ 主机名（你的电脑名）5└─ 用户名Linux 装软件靠 apt，默认从国外服务器下载 —— 在国内会非常慢甚至连不上。换成国内镜像，速度能快几十倍。
在 WSL 的黑色窗口里执行：
1sudo cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak2
3sudo 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输入 sudo 开头的命令会要你输密码 —— 就是刚才设的那个，同样不显示，输完回车。
然后更新软件列表：
1sudo 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 |
这是最重要的一节，很多人在这里浪费时间。
| 位置 | 路径 | 说明 |
|---|---|---|
| Linux 自己的地盘 | /home/w/、~/ | 速度快，权限正常 |
| Windows 的盘 | /mnt/c/、/mnt/d/ | 就是你的 C 盘、D 盘 |
比如你的 Windows 桌面，在 WSL 里是：
1cd /mnt/c/Users/你的用户名/Desktop反过来，在 Windows 上访问 Linux 的文件：
\\wsl$\Ubuntu-24.041# ✅ 正确 —— 放这里，速度快、权限正常2cd ~3mkdir myproject4cd myproject5
6# ❌ 错误 —— 别把项目放 /mnt/c 下跑7cd /mnt/c/Users/w/myproject # 慢很多，还会遇到文件权限 bug为什么？ /mnt/c 是网络共享的方式访问 Windows 文件的，大量小文件读写（比如 npm install、编译代码）会慢 5~10 倍，还可能出诡异的权限问题。
日常用法：代码放 Linux 里，用 VS Code 编辑，需要时再复制回 Windows。
一条命令装上开发中常用的东西：
1sudo 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：
1htop按 q 退出。
Ubuntu 自带 Python 3。验证一下：
1python3 --version推荐再装个现代的包管理工具 uv（比 pip 快 10~100 倍）：
1curl -LsSf https://astral.sh/uv/install.sh | sh装完重启终端，就可以用 uv 管理 Python 包了。
WSL 默认的 NAT 模式已经能用 —— WSL 有自己的 IP，能正常上网、装软件包。这一节你可以先跳过去，等确实需要时再回来调。
网上很多教程推荐开「镜像模式」（networkingMode=mirrored）。
但如果你装了 Clash / v2ray 这类本地代理软件，千万别开。
镜像模式的网络初始化依赖 Windows 代理状态，开关一次梯子就可能导致下次启动报错
0x8007054f 并退化成”无网卡”。踩过这个坑的完整记录见排障篇。
如果要用，先建配置文件。在 Windows 上打开「此电脑」→ 地址栏输入 %USERPROFILE% → 回车，在这个文件夹里新建文件 .wslconfig（注意开头有个点）。
如果提示”必须输入文件名”，用记事本新建：右键 → 新建 → 文本文档 → 重命名为 .wslconfig.（首尾各一个点，Windows 会自动去掉末尾的点）。
稳妥的推荐配置：
1[wsl2]2
3# NAT 是默认模式，写不写都一样；关键是别开 autoProxy4networkingMode=nat5autoProxy=false6
7# 通过 Windows 解析 DNS（NAT 下有效，能修不少奇怪的解析失败）8dnsTunneling=true9
10# 资源限制（按你的电脑配置调整）11memory=8GB12processors=813swap=4GB14
15[experimental]16
17# 空闲时把内存还给 Windows18autoMemoryReclaim=gradual19
20# 防止虚拟磁盘只增不减21sparseVhd=true保存后在 PowerShell 里执行（让配置生效）：
1wsl --shutdown然后重新打开 Ubuntu，配置就生效了。
NAT 模式下 WSL 有独立 IP，127.0.0.1 指的是它自己，够不到 Windows 上的代理。所以要两步：
0.0.0.0:7897 而不只是 127.0.0.11cat >> ~/.bashrc <<'EOF'2
3# ---- WSL proxy (auto-detect) ----4wsl_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; then7 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.*,\10172.19.*,172.20.*,172.21.*,172.22.*,172.23.*,172.24.*,172.25.*,172.26.*,172.27.*,\11172.28.*,172.29.*,172.30.*,172.31.*,mirrors.aliyun.com,mirrors.tuna.tsinghua.edu.cn"12 echo "[proxy] on -> $GW:7897"13 else14 unset http_proxy https_proxy no_proxy15 echo "[proxy] off (梯子没开，国内源直连)"16 fi17}18wsl_proxy19EOF20
21source ~/.bashrc这段脚本会探测网关的 7897 端口是否可达，梯子开着才启用代理，关了就自动取消。好处是关梯子不会让 WSL 变残废 —— 国内镜像源本来就不需要代理。
验证：
1$ curl -sI https://github.com --max-time 10 | head -12HTTP/1.1 200 Connection established # 梯子开着时不确定你的代理端口？Windows 上「设置 → 网络和 Internet → 代理」里能看到，一般是 7890 或 7897。脚本里的 7897 换成你自己的端口即可。
如果启动时报 0x8007054f 或”无法配置网络”，说明 Windows 网络栈有问题，管理员 PowerShell 执行 netsh winsock reset + 重启即可。详见排障篇。
系统自带的终端比较朴素。推荐装 Windows Terminal：
Windows Terminal装好后它会自动识别你的 Ubuntu，一次开启多个标签页（PowerShell、Ubuntu 并存），支持分屏、主题、字体美化。
Windows 11 其实自带 Windows Terminal，开始菜单搜一下可能已经有了。
这是 WSL 最爽的用法之一。
WSL，微软官方那个）1cd ~/myproject2code .第一次会自动在 WSL 里装 VS Code 服务端，之后就能：
这是目前 Windows 上做开发最舒服的组合，强烈建议试试。
如果你想在 WSL 里跑 Docker、数据库、SSH 之类的常驻服务，需要开 systemd。
在 WSL 里执行：
1sudo tee /etc/wsl.conf > /dev/null <<'EOF'2[boot]3systemd=true4EOF然后在 PowerShell 里：
1wsl --shutdown重新打开 Ubuntu，验证：
1systemctl status能正常显示就说明开了。
| 命令 | 作用 |
|---|---|
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 | 从备份恢复 |
| 命令 | 作用 |
|---|---|
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 打开当前目录 |
没有，正常输入即可。Linux 输密码故意不显示任何字符，防止别人看到密码长度。输完回车就行。
sudo 提示 “user is not in the sudoers file”？#说明你用的是 root 或者账号权限有问题。正常创建的账号都能 sudo。如果进了 root（提示符是 #），用 adduser 用户名 再 usermod -aG sudo 用户名 建个新号。
在 PowerShell 里：
1ubuntu2404.exe config --default-user 你的用户名.wslconfig 里加 memory=4GB（按需要调）。另外 autoMemoryReclaim=gradual 会让空闲内存自动还给 Windows。
不用 WSL 时在 PowerShell 执行 wsl --shutdown 可以完全释放内存。
1# 删除某个发行版（数据一并删除）2wsl --unregister Ubuntu-24.043
4# 完全移除 WSL 功能5wsl --shutdown6dism.exe /online /disable-feature /featurename:Microsoft-Windows-Subsystem-Linux7dism.exe /online /disable-feature /featurename:VirtualMachinePlatform然后去「设置 → 应用」卸载 Ubuntu 应用。
能。.wslconfig 加 sparseVhd=true 后，再用：
1wsl --shutdown2Optimize-VHD -Path "$env:LOCALAPPDATA\Packages\*Ubuntu*\LocalState\ext4.vhdx" -Mode FullWindows 11 可以。 直接装了就能用，WSL 会自动转发到 Windows 桌面：
1sudo apt install -y gedit2gedit会弹出一个真正的 Linux 窗口应用在 Windows 桌面上。这叫 WSLg。
两种方案：
docker-ce（需要先开 systemd）新手推荐方案 1。
你大概把 Linux 命令粘到 Windows 里了。 ls、cat、grep、head、env 这些在 PowerShell 里不存在。
wsl、dism、netsh 这些apt、cd、ls、curl 这些这是新手最常见的错误，没有之一。
现在你有一个能用的 Linux 了。推荐按这个顺序玩下去：
ls、cd、pwd、mkdir，别怕，删不坏系统git clone 一个开源项目下来跑跑看遇到问题别慌，错误信息复制去搜，WSL 用户量大，基本都有人踩过。
装不上或者网络出问题？看排障篇，那里记录了六个坑的完整排查过程。
本文记录完整的排查链路、每个阶段的判断依据，以及最后那条一击致命的命令。
如果你只是想装 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，未装任何发行版 |
先做体检，确认硬件层面没问题：
1(Get-ComputerInfo).HyperVisorPresent # True2Get-Service AppXSVC # Running3Get-AppxPackage MicrosoftCorporationII.WindowsSubsystemForLinux虚拟化开着、AppX 部署服务正常、WSL 内核包已存在 —— 只差一个发行版。看起来是顺手的事。
Wsl/CallMsi/REGDB_E_CLASSNOTREG#1wsl --install2wsl: 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 环节。
别按任意键。 它的自动修复基本不会成功，只会让你多等 60 秒。直接 CTRL-C 取消。
AppXSVC（AppX Deployment Service）状态正常，msiserver 是 Manual 按需启动也属正常。所以问题不在服务，而在这条升级链路本身。
微软在 GitHub Release 上提供完整的离线安装包 —— microsoft/WSL/releases。最新版是 wsl.3.0.3.0.x64.msi（约 351 MB）。
国内直连 GitHub Release 经常中断（curl: (56) schannel: server closed abruptly）。用浏览器或下载工具通常更稳，下载完校验一下大小，351 MB 才完整。
管理员 PowerShell 里执行这套组合拳：
1# 1. 停掉 WSL 进程2Get-Process wsl, wslservice -ErrorAction SilentlyContinue | Stop-Process -Force3
4# 2. 卸载损坏的 Store 包（此时未装任何发行版，删它零风险）5Get-AppxPackage MicrosoftCorporationII.WindowsSubsystemForLinux | Remove-AppxPackage6
7# 3. 清掉失效的 wsl.exe 别名8Remove-Item 'HKCU:\Software\Microsoft\Windows\CurrentVersion\App Paths\wsl.exe' -Recurse -Force9
10# 4. 用本地 MSI 安装（/passive 显示进度条，/norestart 不自动重启）11msiexec /i "C:\Users\w\Downloads\wsl.3.0.3.0.x64.msi" /passive /norestart12
13# 5. 确保两个 Windows 功能开着14dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart15dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestartmsiexec 返回 0 或 3010 都算成功（3010 表示需要重启）。
localhost 代理未镜像#重启后装发行版，这次很顺利：
1wsl --install -d Ubuntu-24.042已成功安装分发。可以通过"wsl.exe -d Ubuntu-24.04"启动它3wsl: 检测到 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：
1[wsl2]2networkingMode=mirrored3autoProxy=true然后就是长达一个小时的噩梦开始。
0x8007054f，WSL 直接退化成无网卡#1wsl ~2wsl: 出现了内部错误。3错误代码： CreateInstance/CreateVm/ConfigureNetworking/0x8007054f4wsl: 无法配置网络 (networkingMode Mirrored)，回退到 networkingMode None。注意最后那句：回退到 networkingMode None —— 这不是降级，是这台虚拟机连网卡都没有了。后面所有的”网络不通”都源于此。
本机装了 VMware，有两张虚拟网卡 VMnet1 / VMnet8：
1Get-NetAdapter | Where-Object { $_.InterfaceDescription -match 'TUN|TAP|VMware|Hyper-V' }VMware 的虚拟交换机确实会跟 Hyper-V 抢网络配置，是 mirrored 失败的常见原因。先禁用网卡试：
1Get-NetAdapter -Name "VMware Network Adapter VMnet1","VMware Network Adapter VMnet8" | Disable-NetAdapter -Confirm:$false仍然报 0x8007054f。
再把 VMware 整个卸载、重启：
1Get-Service | Where-Object { $_.Name -match 'VMnet|VMWARE|VMAuthd' } # 空，确认清干净2Get-NetAdapter -IncludeHidden # VMnet 已消失还是报 0x8007054f。
到这里可以确认：VMware 是无辜的。但它背了最久的锅，因为它”看起来最像”。
先回退到 NAT 保命：
1[wsl2]2networkingMode=nat3dnsTunneling=true网络起来了：
1$ ip -4 addr show eth0 | grep inet2inet 172.30.7.40/20 brd 172.30.15.255 scope global eth03$ cat /etc/resolv.conf | grep nameserver4nameserver 10.255.255.254 # dnsTunneling 的隧道地址，正常换清华源后 apt update，索引文件全部下载成功，但 deb 包集体失败：
1Get:1 https://mirrors.tuna.tsinghua.edu.cn/ubuntu noble InRelease [256 kB] ← 成功2Err:1 ... libgssapi-krb5-2_1.20.1-6ubuntu2.10_amd64.deb3 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 即可：
1echo 'Acquire::ForceIPv4 "true";' | sudo tee /etc/apt/apt.conf.d/99force-ipv4同理，curl 在 WSL 里没输出也是这个原因，加 -4 验证：
1curl -4 -sI https://mirrors.tuna.tsinghua.edu.cn --max-time 10 | head -1加了 ForceIPv4 之后，错误里的 IPv6 地址确实消失了，但换成了：
1E: Failed to fetch ... libcurl3t64-gnutls_8.5.0-2ubuntu10.16_amd64.deb2 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 照样失败。代理软件无辜。
顺带一个易忽略的点：只退出梯子软件、但 Windows 的”系统代理”开关还开着（ProxyEnable=1 指向 127.0.0.1:7897），会让 Windows 处于半断网状态，WSL 的 dnsTunneling 也会跟着遭殃。关梯子要连开关一起关。
查 0x8007054f 时确认了两件事：
有个低成本试法：先断网（关 Wi-Fi / 拔网线）→ wsl --shutdown → 启动 WSL → 再连网。断网状态下没有物理网卡可绑定，交换机能干净建起来。
但更彻底、一步到位的是这个（管理员 PowerShell，需重启）：
1wsl --shutdown2net stop hns3net start hns4netsh winsock reset5netsh int ip reset6shutdown /r /t 0重启后再进 WSL —— 报错消失了。
1$ hostname -I2192.168.1.112 fd8e:133f:b5f7:0:bd12:a5a:7ee2:e51d ... # 与 Windows 同网段 + IPv6 都回来了3$ sudo apt update4Fetched 3227 kB in 1s (4548 kB/s) # 一次成功镜像模式正常，代理自动同步，IPv6 可用，apt 跑满速。
当时以为故事到此结束。并没有 —— 第二天它又崩了，而且崩得一模一样。
复现规律是用户自己发现的：
使用途中如果开了代理再关掉，就会弹窗提示重启 WSL，重启之后还是报
0x8007054f。
这条线索一下子把前面所有矛盾都解释了 —— 那天 winsock reset 之后之所以成功，是因为那次启动代理还没打开。
查进程确认本机跑的是 Clash Verge：
1Get-Process | Where-Object { $_.ProcessName -match 'clash|mihomo|verge|sing|v2ray' }1 3532 clash-verge D:\Program Files\Clash Verge\clash-verge.exe227320 verge-mihomo D:\Program Files\Clash Verge\verge-mihomo.exe再看网卡，WSL 的那张 vEthernet (WSL (Hyper-V firewall)) 不见了，多出来一对陌生组件：
1Get-NetAdapter -IncludeHidden | Where-Object { $_.InterfaceDescription -match 'Hyper-V|WSL' }1Name InterfaceDescription Status2---- -------------------- ------3vEthernet (FSE HostVnic) Hyper-V Virtual Ethernet Container Adapter Up4vSwitch (FSE Switch) Hyper-V Virtual Switch Extension Adapter Up代理软件运行时会改 Windows 代理状态、并往 Hyper-V 网络栈里插入自己的组件。 而镜像模式的网络初始化恰恰依赖这份状态 —— 开关一次，状态就不一致了，下次 WSL 起不来。
结论：只要 Windows 上装了本地代理客户端，镜像模式就不稳定。 这不是配置问题，是架构冲突。查资料时其实早就看到这句话 （“只要你在 Windows 开了本地代理，WSL Mirrored 网络就极易报这个错”），当时没当回事。
既然会频繁开关梯子，那就彻底不用镜像模式。NAT 不读 Windows 代理状态，开关梯子对它毫无影响。
代价是 NAT 下 127.0.0.1 够不到 Windows 的代理，得绕一下：
0.0.0.0:7897 而不只是 127.0.0.11cat >> ~/.bashrc <<'EOF'2
3# ---- WSL proxy (auto-detect) ----4wsl_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; then7 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.*,\10172.19.*,172.20.*,172.21.*,172.22.*,172.23.*,172.24.*,172.25.*,172.26.*,172.27.*,\11172.28.*,172.29.*,172.30.*,172.31.*,mirrors.aliyun.com,mirrors.tuna.tsinghua.edu.cn"12 echo "[proxy] on -> $GW:7897"13 else14 unset http_proxy https_proxy no_proxy15 echo "[proxy] off (梯子没开，国内源直连)"16 fi17}18wsl_proxy19EOF20
21source ~/.bashrc脚本用 /dev/tcp 探测网关的 7897 是否可达：开着就 export，关着就 unset。
这样就不会出现”关了梯子导致 WSL 半瘫”的情况 —— 国内源本来也不需要代理。
不想开 Allow LAN 的话，Windows 侧改用端口转发也行（管理员 PowerShell）：
1netsh interface portproxy add v4tov4 listenaddress=<WSL网关IP> listenport=7897 connectaddress=127.0.0.1 connectport=7897只监听网关地址，比 0.0.0.0 安全，代价是 WSL 网段变了要重配。
C:\Users\<你>\.wslconfig：
1[wsl2]2
3# --- 为什么不用 mirrored ---4# 镜像模式初始化网络时依赖 Windows 代理状态，本机跑 Clash Verge，5# 每次开关梯子都会让下一次 WSL 启动报 0x8007054f 并回退 None。6# 结论：有本地代理客户端时，镜像模式不可用。7networkingMode=nat8
9# 必须关：NAT 模式下读取 Windows 代理只会每启动一次的无效警告10autoProxy=false11
12# 通过 Windows 解析 DNS，而不是走 NAT 网关13dnsTunneling=true14
15# 资源限制（i7-13700H / 16GB），按需调整16# 不设的话 WSL 会吃掉约一半内存和全部核心17memory=8GB18processors=819swap=4GB20
21[experimental]22
23# 空闲时把缓存内存还给 Windows24autoMemoryReclaim=gradual25
26# 阻止 ext4.vhdx 只增不减27sparseVhd=trueapt 源（/etc/apt/sources.list.d/ubuntu.sources）：
1Types: deb2URIs: https://mirrors.aliyun.com/ubuntu3Suites: noble noble-updates noble-backports noble-security4Components: main restricted universe multiverse5Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg梯子开着时验证（注意这里是网关 IP 而不是 127.0.0.1，NAT 下 WSL 是独立 IP）：
1$ ip route show default | awk '{print $3}'2172.30.0.13
4$ env | grep -i proxy5http_proxy=http://172.30.0.1:78976https_proxy=http://172.30.0.1:78977no_proxy=localhost,127.0.0.1,192.168.*,10.*,...,mirrors.aliyun.com # 内网自动绕过8
9$ curl -sI https://github.com --max-time 10 | head -110HTTP/1.1 200 Connection established梯子关掉后重开一个终端：
1[proxy] off (梯子没开，国内源直连)2$ curl -sI https://mirrors.aliyun.com --max-time 10 | head -13HTTP/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 转发 |
推荐排查顺序（能省两小时）：
netsh winsock reset + netsh int ip reset + 重启net stop hns / net start hns| 怀疑对象 | 处置 | 结论 |
|---|---|---|
| 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 损坏：
1Set-ExecutionPolicy -Scope Process Bypass -Force2& ".\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
还没装上？看安装教程从零开始。