C#写Pulumi是用真实编程语言构建资源依赖与逻辑，需确保.NET SDK与pulumi CLI版本兼容，资源间传递必须用Output，配置敏感值须通过Pulumi.Config并设为secret，调试需用--debug和日志分析，状态不一致时需CLI手动refresh或import。
用 C# 写 Pulumi 不是“把 ARM 模板翻译成 C#”，而是用真实编程语言构造资源依赖、复用逻辑和条件分支——只要 .NET SDK 和 pulumi CLI 装好，就能直接运行。
安装与初始化：确认 Pulumi CLI 和 .NET 环境兼容
Pulumi 官方支持 .NET 6+，但实际项目中常见踩坑点是 SDK 版本和 pulumi CLI 不匹配。比如 pulumi v3.115.0 在 .NET 8 下运行正常，但某些插件（如 pulumi-aws 6.x）要求 dotnet 6.0.3xx 运行时，否则 pulumi preview 会卡在 “loading plugin” 或抛出 System.DllNotFoundException。
- 先执行
dotnet --list-sdks，确保有至少一个 6.0.x 或 8.0.x 的 SDK - 运行
pulumi version，推荐用v3.115.0或更高稳定版（避免v4.0.0早期预发布版） -
pulumi new aws-csharp生成模板后，检查.csproj中的 - 首次
pulumi up前，务必手动执行一次dotnet restore，Pulumi 不会自动触发它
Stack 类里定义资源：别直接 new Resource，要用 Output 衔接
写 new aws.S3.Bucket("my-bucket") 看似简单，但一旦涉及跨资源引用（比如给 Lambda 设置 S3 触发器），就必须用 Output 传递 ID 或 ARN，不能用普通字符串拼接。否则 pulumi preview 可能显示 “unknown” 或报错 Expected a non-null value for 'bucket'。
- 错误写法：
bucketName = "my-bucket-" + DateTime.Now.ToString("yyyyMMdd")→ 静态字符串无法参与依赖图构建 - 正确写法：
var bucket = new aws.S3.Bucket("my-bucket", new() { BucketPrefix = "prod-" });，然后用bucket.BucketName（类型是Output）传给下游 - 需要拼接字符串？用
Output.Tuple(...).Apply(t => $"prefix-{t.Item1}-{t.Item2}")，而不是$"prefix-{bucket.Id}" - 访问输出值做判断？必须用
.Apply(v => { if (v == "xxx") ... })，不能在外层if (bucket.Id.ToString() == "...")
配置与敏感值：用 Pulumi.Config 读取，别硬编码或塞进 appsettings.json
Pulumi.Config 是唯一被 pulumi login 后端加密保护的配置入口。把 AWS region、DB password 或密钥直接写进 appsettings.json，不仅绕过 Pulumi 的 secret 管理，还会导致 pulumi stack output 泄露明文。
- 定义配置项：
var config = new Config(); var region = config.Require("aws:region"); - 设敏感值：
pulumi config set aws:region us-west-2 --secret，对应代码中用config.RequireSecret("aws:region") - 不要在
Stack构造函数里调用Console.ReadLine()或Environment.GetEnvironmentVariable()—— 这些值不会被记录进 state，也无法被pulumi stack export追踪 - 多环境区分？用
pulumi stack select prod切换后，pulumi config会自动加载对应 stack 的键值
部署失败后怎么查：重点看 pulumi up --debug 和 ~/.pulumi/logs
Pulumi 报错信息常藏在底层 provider 日志里，error: update failed 这类提示太笼统。真正有用的线索往往在 debug 日志末尾或 JSON event 流中。
- 加
--debug参数重试：pulumi up --debug 2>&1 | tee debug.log，搜索"event":"resourcePrepared"后面的 error 字段 - 打开
~/.pulumi/logs/pulumi-resource-aws-*.log（Linux/macOS）或%USERPROFILE%\.pulumi\logs\...（Windows），找ValidationError或AccessDeniedException - 如果卡在 “Creating…” 超过 5 分钟，大概率是 IAM 权限不足或 VPC 配置错误（比如 Subnet 没开 auto-assign public IP，却要部署公网型 LoadBalancer）
- 别依赖 IDE 的“启动调试”按钮——Pulumi 是进程外调用 dotnet run，VS/VS Code 的断点对资源创建逻辑无效
最麻烦的不是语法，是状态同步：一旦手动在 AWS 控制台删了某个资源，Pulumi 的 next up 可能试图重建同名资源并冲突，此时得用 pulumi refresh 或 pulumi import 手动对齐，而这两步在 C# 里没有等价 API，只能走 CLI。
